home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / lib / emacs / 19.22 / etc / DOC < prev    next >
Text File  |  1994-07-07  |  542KB  |  11,768 lines

  1. Fredraw-frame
  2. Clear frame FRAME and output again what is supposed to appear on it.
  3.  
  4. arguments: (frame)Fredraw-frame
  5. Clear frame FRAME and output again what is supposed to appear on it.
  6.  
  7. arguments: (frame)Fredraw-display
  8. Clear and redisplay all visible frames.
  9.  
  10. arguments: ()Fopen-termscript
  11. Start writing all terminal output to FILE as well as the terminal.
  12. FILE = nil means just close any termscript file currently open.
  13.  
  14. arguments: (file)Fsend-string-to-terminal
  15. Send STRING to the terminal without alteration.
  16. Control characters in STRING will have terminal-dependent effects.
  17.  
  18. arguments: (str)Fding
  19. Beep, or flash the screen.
  20. Also, unless an argument is given,
  21. terminate any keyboard macro currently executing.
  22.  
  23. arguments: (&optional arg)Fsleep-for
  24. Pause, without updating display, for SECONDS seconds.
  25. SECONDS may be a floating-point value, meaning that you can wait for a
  26. fraction of a second.  Optional second arg MILLISECONDS specifies an
  27. additional wait period, in milliseconds; this may be useful if your
  28. Emacs was built without floating point support.
  29. (Not all operating systems support waiting for a fraction of a second.)
  30.  
  31. arguments: (seconds &optional milliseconds)Fsit-for
  32. Perform redisplay, then wait for SECONDS seconds or until input is available.
  33. SECONDS may be a floating-point value, meaning that you can wait for a
  34. fraction of a second.  Optional second arg MILLISECONDS specifies an
  35. additional wait period, in milliseconds; this may be useful if your
  36. Emacs was built without floating point support.
  37. (Not all operating systems support waiting for a fraction of a second.)
  38. Optional third arg non-nil means don't redisplay, just wait for input.
  39. Redisplay is preempted as always if input arrives, and does not happen
  40. if input is available before it starts.
  41. Value is t if waited the full time with no input arriving.
  42.  
  43. arguments: (seconds &optional milliseconds nodisp)Vbaud-rate
  44. The output baud rate of the terminal.
  45. On most systems, changing this value will affect the amount of padding
  46. and the other strategic decisions made during redisplay.Vinverse-video
  47. *Non-nil means invert the entire frame display.
  48. This means everything is in inverse video which otherwise would not be.Vvisible-bell
  49. *Non-nil means try to flash the frame to represent a bell.Vno-redraw-on-reenter
  50. *Non-nil means no need to redraw entire frame after suspending.
  51. A non-nil value is useful if the terminal can automatically preserve
  52. Emacs's frame display when you reenter Emacs.
  53. It is up to you to set this variable if your terminal can do that.Vwindow-system
  54. A symbol naming the window-system under which Emacs is running
  55. (such as `x'), or nil if emacs is running on an ordinary terminal.Vwindow-system-version
  56. The version number of the window system in use.
  57. For X windows, this is 10 or 11.Vcursor-in-echo-area
  58. Non-nil means put cursor in minibuffer, at end of any message there.Vglyph-table
  59. Table defining how to output a glyph code to the frame.
  60. If not nil, this is a vector indexed by glyph code to define the glyph.
  61. Each element can be:
  62.  integer: a glyph code which this glyph is an alias for.
  63.  string: output this glyph using that string (not impl. in X windows).
  64.  nil: this glyph mod 256 is char code to output,
  65.     and this glyph / 256 is face code for X windows (see `x-set-face').Vstandard-display-table
  66. Display table to use for buffers that specify none.
  67. See `buffer-display-table' for more information.Fframep
  68. Return non-nil if OBJECT is a frame.
  69. Value is t for a termcap frame (a character-only terminal),
  70. `x' for an Emacs frame that is really an X window.
  71. Also see `live-frame-p'.
  72.  
  73. arguments: (object)Fframe-live-p
  74. Return non-nil if OBJECT is a frame which has not been deleted.
  75. Value is nil if OBJECT is not a live frame.  If object is a live
  76. frame, the return value indicates what sort of output device it is
  77. displayed on.  Value is t for a termcap frame (a character-only
  78. terminal), `x' for an Emacs frame being displayed in an X window.
  79.  
  80. arguments: (object)Fselect-frame
  81. Select the frame FRAME.
  82. Subsequent editing commands apply to its selected window.
  83. The selection of FRAME lasts until the next time the user does
  84. something to select a different frame, or until the next time this
  85. function is called.
  86.  
  87. arguments: (frame &optional no-enter)Fhandle-switch-frame
  88. Handle a switch-frame event EVENT.
  89. Switch-frame events are usually bound to this function.
  90. A switch-frame event tells Emacs that the window manager has requested
  91. that the user's events be directed to the frame mentioned in the event.
  92. This function selects the selected window of the frame of EVENT.
  93.  
  94. If EVENT is frame object, handle it as if it were a switch-frame event
  95. to that frame.
  96.  
  97. arguments: (frame &optional no-enter)Fselected-frame
  98. Return the frame that is now selected.
  99.  
  100. arguments: ()Fwindow-frame
  101. Return the frame object that window WINDOW is on.
  102.  
  103. arguments: (window)Fframe-root-window
  104. Returns the root-window of FRAME.
  105. If omitted, FRAME defaults to the currently selected frame.
  106.  
  107. arguments: (&optional frame)Fframe-selected-window
  108. Return the selected window of frame object FRAME.
  109. If omitted, FRAME defaults to the currently selected frame.
  110.  
  111. arguments: (&optional frame)Fframe-list
  112. Return a list of all frames.
  113.  
  114. arguments: ()Fnext-frame
  115. Return the next frame in the frame list after FRAME.
  116. By default, skip minibuffer-only frames.
  117. If omitted, FRAME defaults to the selected frame.
  118. If optional argument MINIFRAME is nil, exclude minibuffer-only frames.
  119. If MINIFRAME is a window, include only frames using that window for their
  120. minibuffer.
  121. If MINIFRAME is non-nil and not a window, include all frames.
  122.  
  123. arguments: (&optional frame miniframe)Fprevious-frame
  124. Return the previous frame in the frame list before FRAME.
  125. By default, skip minibuffer-only frames.
  126. If omitted, FRAME defaults to the selected frame.
  127. If optional argument MINIFRAME is nil, exclude minibuffer-only frames.
  128. If MINIFRAME is a window, include only frames using that window for their
  129. minibuffer.
  130. If MINIFRAME is non-nil and not a window, include all frames.
  131.  
  132. arguments: (&optional frame miniframe)Fdelete-frame
  133. Delete FRAME, permanently eliminating it from use.
  134. If omitted, FRAME defaults to the selected frame.
  135. A frame may not be deleted if its minibuffer is used by other frames.
  136. Normally, you may not delete a frame if all other frames are invisible,
  137. but if the second optional argument FORCE is non-nil, you may do so.
  138.  
  139. arguments: (&optional frame force)Fmouse-position
  140. Return a list (FRAME X . Y) giving the current mouse frame and position.
  141. The position is given in character cells, where (0, 0) is the
  142. upper-left corner.
  143. If Emacs is running on a mouseless terminal or hasn't been programmed
  144. to read the mouse position, it returns the selected frame for FRAME
  145. and nil for X and Y.
  146.  
  147. arguments: ()Fset-mouse-position
  148. Move the mouse pointer to the center of character cell (X,Y) in FRAME.
  149. WARNING:  If you use this under X, you should do `unfocus-frame' afterwards.
  150.  
  151. arguments: (frame x y)Fmake-frame-visible
  152. Make the frame FRAME visible (assuming it is an X-window).
  153. If omitted, FRAME defaults to the currently selected frame.
  154.  
  155. arguments: (&optional frame)Fmake-frame-invisible
  156. Make the frame FRAME invisible (assuming it is an X-window).
  157. If omitted, FRAME defaults to the currently selected frame.
  158.  
  159. arguments: (&optional frame)Ficonify-frame
  160. Make the frame FRAME into an icon.
  161. If omitted, FRAME defaults to the currently selected frame.
  162.  
  163. arguments: (&optional frame)Fframe-visible-p
  164. Return t if FRAME is now "visible" (actually in use for display).
  165. A frame that is not "visible" is not updated and, if it works through
  166. a window system, it may not show at all.
  167. Return the symbol `icon' if frame is visible only as an icon.
  168.  
  169. arguments: (frame)Fvisible-frame-list
  170. Return a list of all frames now "visible" (being updated).
  171.  
  172. arguments: ()Fraise-frame
  173. Bring FRAME to the front, so it occludes any frames it overlaps.
  174. If FRAME is invisible, make it visible.
  175. If Emacs is displaying on an ordinary terminal or some other device which
  176. doesn't support multiple overlapping frames, this function does nothing.
  177.  
  178. arguments: (frame)Flower-frame
  179. Send FRAME to the back, so it is occluded by any frames that overlap it.
  180. If Emacs is displaying on an ordinary terminal or some other device which
  181. doesn't support multiple overlapping frames, this function does nothing.
  182.  
  183. arguments: (frame)Fredirect-frame-focus
  184. Arrange for keystrokes typed at FRAME to be sent to FOCUS-FRAME.
  185. In other words, switch-frame events caused by events in FRAME will
  186. request a switch to FOCUS-FRAME, and `last-event-frame' will be
  187. FOCUS-FRAME after reading an event typed at FRAME.
  188.  
  189. If FOCUS-FRAME is omitted or nil, any existing redirection is
  190. cancelled, and the frame again receives its own keystrokes.
  191.  
  192. Focus redirection is useful for temporarily redirecting keystrokes to
  193. a surrogate minibuffer frame when a frame doesn't have its own
  194. minibuffer window.
  195.  
  196. A frame's focus redirection can be changed by select-frame.  If frame
  197. FOO is selected, and then a different frame BAR is selected, any
  198. frames redirecting their focus to FOO are shifted to redirect their
  199. focus to BAR.  This allows focus redirection to work properly when the
  200. user switches from one frame to another using `select-window'.
  201.  
  202. This means that a frame whose focus is redirected to itself is treated
  203. differently from a frame whose focus is redirected to nil; the former
  204. is affected by select-frame, while the latter is not.
  205.  
  206. The redirection lasts until `redirect-frame-focus' is called to change it.
  207.  
  208. arguments: (frame &optional focus-frame)Fframe-focus
  209. Return the frame to which FRAME's keystrokes are currently being sent.
  210. This returns nil if FRAME's focus is not redirected.
  211. See `redirect-frame-focus'.
  212.  
  213. arguments: (frame)Fframe-parameters
  214. Return the parameters-alist of frame FRAME.
  215. It is a list of elements of the form (PARM . VALUE), where PARM is a symbol.
  216. The meaningful PARMs depend on the kind of frame.
  217. If FRAME is omitted, return information on the currently selected frame.
  218.  
  219. arguments: (&optional frame)Fmodify-frame-parameters
  220. Modify the parameters of frame FRAME according to ALIST.
  221. ALIST is an alist of parameters to change and their new values.
  222. Each element of ALIST has the form (PARM . VALUE), where PARM is a symbol.
  223. The meaningful PARMs depend on the kind of frame; undefined PARMs are ignored.
  224.  
  225. arguments: (frame alist)Fframe-char-height
  226. Height in pixels of a line in the font in frame FRAME.
  227. If FRAME is omitted, the selected frame is used.
  228. For a terminal frame, the value is always 1.
  229.  
  230. arguments: (&optional frame)Fframe-char-width
  231. Width in pixels of characters in the font in frame FRAME.
  232. If FRAME is omitted, the selected frame is used.
  233. The width is the same for all characters, because
  234. currently Emacs supports only fixed-width fonts.
  235. For a terminal screen, the value is always 1.
  236.  
  237. arguments: (&optional frame)Fframe-pixel-height
  238. Return a FRAME's height in pixels.
  239. For a terminal frame, the result really gives the height in characters.
  240. If FRAME is omitted, the selected frame is used.
  241.  
  242. arguments: (&optional frame)Fframe-pixel-width
  243. Return FRAME's width in pixels.
  244. For a terminal frame, the result really gives the width in characters.
  245. If FRAME is omitted, the selected frame is used.
  246.  
  247. arguments: (&optional frame)Fset-frame-height
  248. Specify that the frame FRAME has LINES lines.
  249. Optional third arg non-nil means that redisplay should use LINES lines
  250. but that the idea of the actual height of the frame should not be changed.
  251.  
  252. arguments: (frame rows &optional pretend)Fset-frame-width
  253. Specify that the frame FRAME has COLS columns.
  254. Optional third arg non-nil means that redisplay should use COLS columns
  255. but that the idea of the actual width of the frame should not be changed.
  256.  
  257. arguments: (frame cols &optional pretend)Fset-frame-size
  258. Sets size of FRAME to COLS by ROWS, measured in characters.
  259.  
  260. arguments: (frame cols rows)Fset-frame-position
  261. Sets position of FRAME in pixels to XOFFSET by YOFFSET.
  262. This is actually the position of the upper left corner of the frame.
  263. Negative values for XOFFSET or YOFFSET are interpreted relative to
  264. the rightmost or bottommost possible position (that stays within the screen).
  265.  
  266. arguments: (frame xoffset yoffset)Vterminal-frame
  267. The initial frame-object, which represents Emacs's stdout.Vemacs-iconified
  268. Non-nil if all of emacs is iconified and frame updates are not needed.Vdefault-minibuffer-frame
  269. Minibufferless frames use this frame's minibuffer.
  270.  
  271. Emacs cannot create minibufferless frames unless this is set to an
  272. appropriate surrogate.
  273.  
  274. Emacs consults this variable only when creating minibufferless
  275. frames; once the frame is created, it sticks with its assigned
  276. minibuffer, no matter what this variable is set to.  This means that
  277. this variable doesn't necessarily say anything meaningful about the
  278. current set of frames, or where the minibuffer is currently being
  279. displayed.Vdefault-frame-alist
  280. Alist of default values for frame creation.
  281. These may be set in your init file, like this:
  282.   (setq default-frame-alist '((width . 80) (height . 55)))
  283. These override values given in window system configuration data, like
  284. X Windows' defaults database.
  285. For values specific to the first Emacs frame, see `initial-frame-alist'.
  286. For values specific to the separate minibuffer frame, see
  287. `minibuffer-frame-alist'.Fselected-frame
  288. Return the frame that is now selected.
  289.  
  290. arguments: ()Fframep
  291. Return non-nil if OBJECT is a frame.
  292. Value is t for a termcap frame (a character-only terminal),
  293. `x' for an Emacs frame that is really an X window.
  294. Also see `live-frame-p'.
  295.  
  296. arguments: (object)Fset-frame-height
  297. Specify that the frame FRAME has LINES lines.
  298. Optional third arg non-nil means that redisplay should use LINES lines
  299. but that the idea of the actual height of the frame should not be changed.
  300.  
  301. arguments: (frame rows &optional pretend)Fset-frame-width
  302. Specify that the frame FRAME has COLS columns.
  303. Optional third arg non-nil means that redisplay should use COLS columns
  304. but that the idea of the actual width of the frame should not be changed.
  305.  
  306. arguments: (frame cols &optional pretend)Fset-frame-size
  307. Sets size of FRAME to COLS by ROWS, measured in characters.
  308.  
  309. arguments: (frame cols rows)Fframe-height
  310. Return number of lines available for display on FRAME.
  311. If FRAME is omitted, describe the currently selected frame.
  312.  
  313. arguments: (&optional frame)Fframe-width
  314. Return number of columns available for display on FRAME.
  315. If FRAME is omitted, describe the currently selected frame.
  316.  
  317. arguments: (&optional frame)Fframe-char-height
  318. Height in pixels of a line in the font in frame FRAME.
  319. If FRAME is omitted, the selected frame is used.
  320. For a terminal frame, the value is always 1.
  321.  
  322. arguments: (&optional frame)Fframe-char-width
  323. Width in pixels of characters in the font in frame FRAME.
  324. If FRAME is omitted, the selected frame is used.
  325. The width is the same for all characters, because
  326. currently Emacs supports only fixed-width fonts.
  327. For a terminal screen, the value is always 1.
  328.  
  329. arguments: (&optional frame)Fframe-pixel-height
  330. Return FRAME's height in pixels.
  331. For a terminal frame, the result really gives the height in characters.
  332. If FRAME is omitted, the selected frame is used.
  333.  
  334. arguments: (&optional frame)Fframe-pixel-width
  335. Return FRAME's width in pixels.
  336. For a terminal frame, the result really gives the width in characters.
  337. If FRAME is omitted, the selected frame is used.
  338.  
  339. arguments: (&optional frame)Fset-screen-height
  340. Tell redisplay that the screen has LINES lines.
  341. Optional second arg non-nil means that redisplay should use LINES lines
  342. but that the idea of the actual height of the screen should not be changed.
  343.  
  344. arguments: (lines &optional pretend)Fset-screen-width
  345. Tell redisplay that the screen has COLS columns.
  346. Optional second arg non-nil means that redisplay should use COLS columns
  347. but that the idea of the actual width of the screen should not be changed.
  348.  
  349. arguments: (cols &optional pretend)Vglobal-mode-string
  350. String (or mode line construct) included (normally) in `mode-line-format'.Voverlay-arrow-position
  351. Marker for where to display an arrow on top of the buffer text.
  352. This must be the beginning of a line in order to work.
  353. See also `overlay-arrow-string'.Voverlay-arrow-string
  354. String to display as an arrow.  See also `overlay-arrow-position'.Vscroll-step
  355. *The number of lines to try scrolling a window by when point moves out.
  356. If that fails to bring point back on frame, point is centered instead.
  357. If this is zero, point is always centered after it moves off frame.Vdebug-end-pos
  358. Don't askVtruncate-partial-width-windows
  359. *Non-nil means truncate lines in all windows less than full frame wide.Vmode-line-inverse-video
  360. *Non-nil means use inverse video for the mode line.Vline-number-display-limit
  361. *Maximum buffer size for which line number should be displayed.Vhighlight-nonselected-windows
  362. *Non-nil means highlight region even in nonselected windows.Fwindowp
  363. Returns t if OBJ is a window.
  364.  
  365. arguments: (obj)Fwindow-live-p
  366. Returns t if OBJ is a window which is currently visible.
  367.  
  368. arguments: (obj)Fselected-window
  369. Return the window that the cursor now appears in and commands apply to.
  370.  
  371. arguments: ()Fminibuffer-window
  372. Return the window used now for minibuffers.
  373. If the optional argument FRAME is specified, return the minibuffer window
  374. used by that frame.
  375.  
  376. arguments: (&optional frame)Fwindow-minibuffer-p
  377. Returns non-nil if WINDOW is a minibuffer window.
  378.  
  379. arguments: (&optional window)Fpos-visible-in-window-p
  380. Return t if position POS is currently on the frame in WINDOW.
  381. Returns nil if that position is scrolled vertically out of view.
  382. POS defaults to point; WINDOW, to the selected window.
  383.  
  384. arguments: (&optional pos window)Fwindow-buffer
  385. Return the buffer that WINDOW is displaying.
  386.  
  387. arguments: (&optional window)Fwindow-height
  388. Return the number of lines in WINDOW (including its mode line).
  389.  
  390. arguments: (&optional window)Fwindow-width
  391. Return the number of columns in WINDOW.
  392.  
  393. arguments: (&optional window)Fwindow-hscroll
  394. Return the number of columns by which WINDOW is scrolled from left margin.
  395.  
  396. arguments: (&optional window)Fset-window-hscroll
  397. Set number of columns WINDOW is scrolled from left margin to NCOL.
  398. NCOL should be zero or positive.
  399.  
  400. arguments: (window ncol)Fwindow-edges
  401. Return a list of the edge coordinates of WINDOW.
  402. (LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of frame.
  403. RIGHT is one more than the rightmost column used by WINDOW,
  404. and BOTTOM is one more than the bottommost row used by WINDOW
  405.  and its mode-line.
  406.  
  407. arguments: (&optional window)Fcoordinates-in-window-p
  408. Return non-nil if COORDINATES are in WINDOW.
  409. COORDINATES is a cons of the form (X . Y), X and Y being distances
  410. measured in characters from the upper-left corner of the frame.
  411. (0 .  0) denotes the character in the upper left corner of the
  412. frame.
  413. If COORDINATES are in the text portion of WINDOW,
  414.    the coordinates relative to the window are returned.
  415. If they are in the mode line of WINDOW, `mode-line' is returned.
  416. If they are on the border between WINDOW and its right sibling,
  417.    `vertical-line' is returned.
  418.  
  419. arguments: (coordinates window)Fwindow-at
  420. Return window containing coordinates X and Y on FRAME.
  421. If omitted, FRAME defaults to the currently selected frame.
  422. The top left corner of the frame is considered to be row 0,
  423. column 0.
  424.  
  425. arguments: (x y &optional frame)Fwindow-point
  426. Return current value of point in WINDOW.
  427. For a nonselected window, this is the value point would have
  428. if that window were selected.
  429.  
  430. Note that, when WINDOW is the selected window and its buffer
  431. is also currently selected, the value returned is the same as (point).
  432. It would be more strictly correct to return the `top-level' value
  433. of point, outside of any save-excursion forms.
  434. But that is hard to define.
  435.  
  436. arguments: (&optional window)Fwindow-start
  437. Return position at which display currently starts in WINDOW.
  438.  
  439. arguments: (&optional window)Fwindow-end
  440. Return position at which display currently ends in WINDOW.
  441.  
  442. arguments: (&optional window)Fset-window-point
  443. Make point value in WINDOW be at position POS in WINDOW's buffer.
  444.  
  445. arguments: (window pos)Fset-window-start
  446. Make display in WINDOW start at position POS in WINDOW's buffer.
  447. Optional third arg NOFORCE non-nil inhibits next redisplay
  448. from overriding motion of point in order to display at this exact start.
  449.  
  450. arguments: (window pos &optional noforce)Fwindow-dedicated-p
  451. Return WINDOW's dedicated object, usually t or nil.
  452. See also `set-window-dedicated-p'.
  453.  
  454. arguments: (window)Fset-window-dedicated-p
  455. Control whether WINDOW is dedicated to the buffer it displays.
  456. If it is dedicated, Emacs will not automatically change
  457. which buffer appears in it.
  458. The second argument is the new value for the dedication flag;
  459. non-nil means yes.
  460.  
  461. arguments: (window arg)Fwindow-display-table
  462. Return the display-table that WINDOW is using.
  463.  
  464. arguments: (&optional window)Fset-window-display-table
  465. Set WINDOW's display-table to TABLE.
  466.  
  467. arguments: (window table)Fdelete-window
  468. Remove WINDOW from the display.  Default is selected window.
  469.  
  470. arguments: (&optional window)Fnext-window
  471. Return next window after WINDOW in canonical ordering of windows.
  472. If omitted, WINDOW defaults to the selected window.
  473.  
  474. Optional second arg MINIBUF t means count the minibuffer window even
  475. if not active.  MINIBUF nil or omitted means count the minibuffer iff
  476. it is active.  MINIBUF neither t nor nil means not to count the
  477. minibuffer even if it is active.
  478.  
  479. Several frames may share a single minibuffer; if the minibuffer
  480. counts, all windows on all frames that share that minibuffer count
  481. too.  This means that next-window may be used to iterate through the
  482. set of windows even when the minibuffer is on another frame.  If the
  483. minibuffer does not count, only windows from WINDOW's frame count.
  484.  
  485. Optional third arg ALL-FRAMES t means include windows on all frames.
  486. ALL-FRAMES nil or omitted means cycle within the frames as specified
  487. above.  If neither nil nor t, restrict to WINDOW's frame.
  488.  
  489. If you use consistent values for MINIBUF and ALL-FRAMES, you can use
  490. `next-window' to iterate through the entire cycle of acceptable
  491. windows, eventually ending up back at the window you started with.
  492. `previous-window' traverses the same cycle, in the reverse order.
  493.  
  494. arguments: (&optional window minibuf all-frames)Fprevious-window
  495. Return the window preceeding WINDOW in canonical ordering of windows.
  496. If omitted, WINDOW defaults to the selected window.
  497.  
  498. Optional second arg MINIBUF t means count the minibuffer window even
  499. if not active.  MINIBUF nil or omitted means count the minibuffer iff
  500. it is active.  MINIBUF neither t nor nil means not to count the
  501. minibuffer even if it is active.
  502.  
  503. Several frames may share a single minibuffer; if the minibuffer
  504. counts, all windows on all frames that share that minibuffer count
  505. too.  This means that previous-window may be used to iterate through
  506. the set of windows even when the minibuffer is on another frame.  If
  507. the minibuffer does not count, only windows from WINDOW's frame
  508. count.
  509.  
  510. Optional third arg ALL-FRAMES t means include windows on all frames.
  511. ALL-FRAMES nil or omitted means cycle within the frames as specified
  512. above.  If neither nil nor t, restrict to WINDOW's frame.
  513.  
  514. If you use consistent values for MINIBUF and ALL-FRAMES, you can use
  515. `previous-window' to iterate through the entire cycle of acceptable
  516. windows, eventually ending up back at the window you started with.
  517. `next-window' traverses the same cycle, in the reverse order.
  518.  
  519. arguments: (&optional window minibuf all-frames)Fother-window
  520. Select the ARG'th different window on this frame.
  521. All windows on current frame are arranged in a cyclic order.
  522. This command selects the window ARG steps away in that order.
  523. A negative ARG moves in the opposite order.  If the optional second
  524. argument ALL_FRAMES is non-nil, cycle through all frames.
  525.  
  526. arguments: (n &optional all-frames)Fget-lru-window
  527. Return the window least recently selected or used for display.
  528. If optional argument FRAMES is t, search all frames.  If FRAME is a
  529. frame, search only that frame.
  530.  
  531.  
  532. arguments: (&optional frames)Fget-largest-window
  533. Return the largest window in area.
  534. If optional argument FRAMES is t, search all frames.  If FRAME is a
  535. frame, search only that frame.
  536.  
  537.  
  538. arguments: (&optional frame)Fget-buffer-window
  539. Return a window currently displaying BUFFER, or nil if none.
  540. If optional argument FRAME is t, search all visible frames.
  541. If FRAME is nil, search only the selected frame.
  542. If FRAME is a frame, search only that frame.
  543.  
  544.  
  545. arguments: (buffer &optional frame)Fdelete-other-windows
  546. Make WINDOW (or the selected window) fill its frame.
  547. Only the frame WINDOW is on is affected.
  548. This function tries to reduce display jumps
  549. by keeping the text previously visible in WINDOW
  550. in the same place on the frame.  Doing this depends on
  551. the value of (window-start WINDOW), so if calling this function
  552. in a program gives strange scrolling, make sure the window-start
  553. value is reasonable when this function is called.
  554.  
  555. arguments: (&optional window)Fdelete-windows-on
  556. Delete all windows showing BUFFER.
  557. Optional second argument FRAME controls which frames are affected.
  558. If nil or omitted, delete all windows showing BUFFER in any frame.
  559. If t, delete only windows showing BUFFER in the selected frame.
  560. If a frame, delete only windows showing BUFFER in that frame.
  561.  
  562. arguments: (buffer &optional frame)Freplace-buffer-in-windows
  563. Replace BUFFER with some other buffer in all windows showing it.
  564.  
  565. arguments: (buffer)Fset-window-buffer
  566. Make WINDOW display BUFFER as its contents.
  567. BUFFER can be a buffer or buffer name.
  568.  
  569. arguments: (window buffer)Fselect-window
  570. Select WINDOW.  Most editing will apply to WINDOW's buffer.
  571. The main editor command loop selects the buffer of the selected window
  572. before each command.
  573.  
  574. arguments: (window)Fdisplay-buffer
  575. Make BUFFER appear in some window but don't select it.
  576. BUFFER can be a buffer or a buffer name.
  577. If BUFFER is shown already in some window, just use that one,
  578. unless the window is the selected window and the optional second
  579. argument NOT-THIS-WINDOW is non-nil (interactively, with prefix arg).
  580. Returns the window displaying BUFFER.
  581.  
  582. arguments: (buffer &optional not-this-window)Fsplit-window
  583. Split WINDOW, putting SIZE lines in the first of the pair.
  584. WINDOW defaults to selected one and SIZE to half its size.
  585. If optional third arg HOR-FLAG is non-nil, split side by side
  586. and put SIZE columns in the first of the pair.
  587.  
  588. arguments: (&optional window chsize horflag)Fenlarge-window
  589. Make current window ARG lines bigger.
  590. From program, optional second arg non-nil means grow sideways ARG columns.
  591.  
  592. arguments: (n &optional side)Fshrink-window
  593. Make current window ARG lines smaller.
  594. From program, optional second arg non-nil means shrink sideways ARG columns.
  595.  
  596. arguments: (n &optional side)Fscroll-up
  597. Scroll text of current window upward ARG lines; or near full screen if no ARG.
  598. A near full screen is `next-screen-context-lines' less than a full screen.
  599. When calling from a program, supply a number as argument or nil.
  600.  
  601. arguments: (&optional n)Fscroll-down
  602. Scroll text of current window downward ARG lines; or near full screen if no ARG.
  603. A near full screen is `next-screen-context-lines' less than a full screen.
  604. When calling from a program, supply a number as argument or nil.
  605.  
  606. arguments: (&optional n)Fscroll-other-window
  607. Scroll next window upward ARG lines; or near full screen if no ARG.
  608. The next window is the one below the current one; or the one at the top
  609. if the current one is at the bottom.
  610. When calling from a program, supply a number as argument or nil.
  611.  
  612. If in the minibuffer, `minibuf-scroll-window' if non-nil
  613. specifies the window to scroll.
  614. If `other-window-scroll-buffer' is non-nil, scroll the window
  615. showing that buffer, popping the buffer up if necessary.
  616.  
  617. arguments: (&optional n)Fscroll-left
  618. Scroll selected window display ARG columns left.
  619. Default for ARG is window width minus 2.
  620.  
  621. arguments: (&optional arg)Fscroll-right
  622. Scroll selected window display ARG columns right.
  623. Default for ARG is window width minus 2.
  624.  
  625. arguments: (&optional arg)Frecenter
  626. Center point in window and redisplay frame.  With ARG, put point on line ARG.
  627. The desired position of point is always relative to the current window.
  628. Just C-u as prefix means put point in the center of the window.
  629. No arg (i.e., it is nil) erases the entire frame and then
  630. redraws with point in the center of the current window.
  631.  
  632. arguments: (&optional n)Fmove-to-window-line
  633. Position point relative to window.
  634. With no argument, position text at center of window.
  635. An argument specifies frame line; zero means top of window,
  636. negative means relative to bottom of window.
  637.  
  638. arguments: (arg)Fwindow-configuration-p
  639. T if OBJECT is a window-configration object.
  640.  
  641. arguments: (obj)Fset-window-configuration
  642. Set the configuration of windows and buffers as specified by CONFIGURATION.
  643. CONFIGURATION must be a value previously returned
  644. by `current-window-configuration' (which see).
  645.  
  646. arguments: (configuration)Fcurrent-window-configuration
  647. Return an object representing the current window configuration of FRAME.
  648. If FRAME is nil or omitted, use the selected frame.
  649. This describes the number of windows, their sizes and current buffers,
  650. and for each displayed buffer, where display starts, and the positions of
  651. point and mark.  An exception is made for point in the current buffer:
  652. its value is -not- saved.
  653. This also records the currently selected frame, and FRAME's focus
  654. redirection (see `redirect-frame-focus').
  655.  
  656. arguments: (&optional frame)Fsave-window-excursion
  657. Execute body, preserving window sizes and contents.
  658. Restores which buffer appears in which window, where display starts,
  659. as well as the current buffer.
  660. Does not restore the value of point in current buffer.Vtemp-buffer-show-function
  661. Non-nil means call as function to display a help buffer.
  662. Used by `with-output-to-temp-buffer'.Vdisplay-buffer-function
  663. If non-nil, function to call to handle `display-buffer'.
  664. It will receive two args, the buffer and a flag which if non-nil means
  665.  that the currently selected window is not acceptable.
  666. Commands such as `switch-to-buffer-other-window' and `find-file-other-window'
  667. work using this function.Vminibuffer-scroll-window
  668. Non-nil means it is the window that C-M-v in minibuffer should scroll.Vother-window-scroll-buffer
  669. If non-nil, this is a buffer and \[scroll-other-window] should scroll its window.Vpop-up-frames
  670. *Non-nil means `display-buffer' should make a separate frame.Vpop-up-frame-function
  671. *If non-nil, function to call to handle automatic new frame creation.
  672. It is called with no arguments and should return a newly created frame.
  673.  
  674. A typical value might be `(lambda () (new-frame pop-up-frame-alist))'
  675. where `pop-up-frame-alist' would hold the default frame parameters.Vpop-up-windows
  676. *Non-nil means display-buffer should make new windows.Vnext-screen-context-lines
  677. *Number of lines of continuity when scrolling by screenfuls.Vsplit-height-threshold
  678. *display-buffer would prefer to split the largest window if this large.
  679. If there is only one window, it is split regardless of this value.Vwindow-min-height
  680. *Delete any window less than this tall (including its mode line).Vwindow-min-width
  681. *Delete any window less than this wide.Fx-get-resource
  682. Return the value of ATTRIBUTE, of class CLASS, from the X defaults database.
  683. This uses `NAME.ATTRIBUTE' as the key and `Emacs.CLASS' as the
  684. class, where INSTANCE is the name under which Emacs was invoked, or
  685. the name specified by the `-name' or `-rn' command-line arguments.
  686.  
  687. The optional arguments COMPONENT and SUBCLASS add to the key and the
  688. class, respectively.  You must specify both of them or neither.
  689. If you specify them, the key is `NAME.COMPONENT.ATTRIBUTE'
  690. and the class is `Emacs.CLASS.SUBCLASS'.
  691.  
  692. arguments: (attribute class &optional component subclass)Fx-get-default
  693. Get X default ATTRIBUTE from the system, or nil if no default.
  694. Value is a string (when not nil) and ATTRIBUTE is also a string.
  695. The defaults are specified in the file `~/.Xdefaults'.
  696.  
  697. arguments: (arg)Fx-parse-geometry
  698. Parse an X-style geometry string STRING.
  699. Returns an alist of the form ((top . TOP), (left . LEFT) ... ).
  700.  
  701. arguments: (string)Fx-create-frame
  702. Make a new X window, which is called a "frame" in Emacs terms.
  703. Return an Emacs frame object representing the X window.
  704. ALIST is an alist of frame parameters.
  705. If the parameters specify that the frame should not have a minibuffer,
  706. and do not specify a specific minibuffer window to use,
  707. then `default-minibuffer-frame' must be a frame whose minibuffer can
  708. be shared by the new frame.
  709.  
  710. arguments: (parms)Ffocus-frame
  711. Set the focus on FRAME.
  712.  
  713. arguments: (frame)Funfocus-frame
  714. If a frame has been focused, release it.
  715.  
  716. arguments: ()Fx-list-fonts
  717. Return a list of the names of available fonts matching PATTERN.
  718. If optional arguments FACE and FRAME are specified, return only fonts
  719. the same size as FACE on FRAME.
  720.  
  721. PATTERN is a string, perhaps with wildcard characters;
  722.   the * character matches any substring, and
  723.   the ? character matches any single character.
  724.   PATTERN is case-insensitive.
  725. FACE is a face name - a symbol.
  726.  
  727. The return value is a list of strings, suitable as arguments to
  728. set-face-font.
  729.  
  730. The list does not include fonts Emacs can't use (i.e.  proportional
  731. fonts), even if they match PATTERN and FACE.
  732.  
  733. arguments: (pattern &optional face frame)Fx-color-defined-p
  734. Return t if the current X display supports the color named COLOR.
  735.  
  736. arguments: (color)Fx-display-color-p
  737. Return t if the X screen currently in use supports color.
  738.  
  739. arguments: ()Fx-display-pixel-width
  740. Returns the width in pixels of the display FRAME is on.
  741.  
  742. arguments: (&optional frame)Fx-display-pixel-height
  743. Returns the height in pixels of the display FRAME is on.
  744.  
  745. arguments: (&optional frame)Fx-display-planes
  746. Returns the number of bitplanes of the display FRAME is on.
  747.  
  748. arguments: (&optional frame)Fx-display-color-cells
  749. Returns the number of color cells of the display FRAME is on.
  750.  
  751. arguments: (&optional frame)Fx-server-max-request-size
  752. Returns the maximum request size of the X server FRAME is using.
  753.  
  754. arguments: (&optional frame)Fx-server-vendor
  755. Returns the vendor ID string of the X server FRAME is on.
  756.  
  757. arguments: (&optional frame)Fx-server-version
  758. Returns the version numbers of the X server in use.
  759. The value is a list of three integers: the major and minor
  760. version numbers of the X Protocol in use, and the vendor-specific release
  761. number.  See also the variable `x-server-vendor'.
  762.  
  763. arguments: (&optional frame)Fx-display-screens
  764. Returns the number of screens on the X server FRAME is on.
  765.  
  766. arguments: (&optional frame)Fx-display-mm-height
  767. Returns the height in millimeters of the X screen FRAME is on.
  768.  
  769. arguments: (&optional frame)Fx-display-mm-width
  770. Returns the width in millimeters of the X screen FRAME is on.
  771.  
  772. arguments: (&optional frame)Fx-display-backing-store
  773. Returns an indication of whether the X screen FRAME is on does backing store.
  774. The value may be `always', `when-mapped', or `not-useful'.
  775.  
  776. arguments: (&optional frame)Fx-display-visual-class
  777. Returns the visual class of the display `screen' is on.
  778. The value is one of the symbols `static-gray', `gray-scale',
  779. `static-color', `pseudo-color', `true-color', or `direct-color'.
  780.  
  781. arguments: (&optional screen)Fx-display-save-under
  782. Returns t if the X screen FRAME is on supports the save-under feature.
  783.  
  784. arguments: (&optional frame)Fx-draw-rectangle
  785. Draw a rectangle on FRAME between coordinates specified by
  786. numbers X0, Y0, X1, Y1 in the cursor pixel.
  787.  
  788. arguments: (frame X0 Y0 X1 Y1)Fx-erase-rectangle
  789. Draw a rectangle drawn on FRAME between coordinates
  790. X0, Y0, X1, Y1 in the regular background-pixel.
  791.  
  792. arguments: (frame X0 Y0 X1 Y1)Fx-contour-region
  793. Highlight the region between point and the character under the mouse
  794. selected frame.
  795.  
  796. arguments: (event)Fx-uncontour-region
  797. Erase any highlighting of the region between point and the character
  798. at X, Y on the selected frame.
  799.  
  800. arguments: (event)Fx-select-region
  801.  
  802.  
  803. arguments: (event)Fx-horizontal-line
  804.  
  805.  
  806. arguments: (event)Fx-track-pointer
  807. Track the pointer.
  808.  
  809. arguments: ()Fx-track-pointer
  810. Draw rectangle around character under mouse pointer, if there is one.
  811.  
  812. arguments: (event)Fx-store-cut-buffer
  813. Store contents of STRING into the cut buffer of the X window system.
  814.  
  815. arguments: (string)Fx-get-cut-buffer
  816. Return contents of cut buffer of the X window system, as a string.
  817.  
  818. arguments: ()Fx-rebind-key
  819. Rebind X keysym KEYSYM, with MODIFIERS, to generate NEWSTRING.
  820. KEYSYM is a string which conforms to the X keysym definitions found
  821. in X11/keysymdef.h, sans the initial XK_. MODIFIERS is nil or a
  822. list of strings specifying modifier keys such as Control_L, which must
  823. also be depressed for NEWSTRING to appear.
  824.  
  825. arguments: (x-keysym modifiers newstring)Fx-rebind-keys
  826. Rebind KEYCODE to list of strings STRINGS.
  827. STRINGS should be a list of 16 elements, one for each shift combination.
  828. nil as element means don't change.
  829. See the documentation of `x-rebind-key' for more information.
  830.  
  831. arguments: (keycode strings)Fx-open-connection
  832. Open a connection to an X server.
  833. DISPLAY is the name of the display to connect to.
  834. Optional second arg XRM_STRING is a string of resources in xrdb format.
  835.  
  836. arguments: (display &optional xrm-string)Fx-close-current-connection
  837. Close the connection to the current X server.
  838.  
  839. arguments: ()Fx-synchronize
  840. If ON is non-nil, report X errors as soon as the erring request is made.
  841. If ON is nil, allow buffering of requests.
  842. Turning on synchronization prohibits the Xlib routines from buffering
  843. requests and seriously degrades performance, but makes debugging much
  844. easier.
  845.  
  846. arguments: (on)Vmouse-buffer-offset
  847. The buffer offset of the character under the pointer.Vx-pointer-shape
  848. The shape of the pointer when over text.
  849. Changing the value does not affect existing frames
  850. unless you set the mouse color.Vx-resource-name
  851. The name Emacs uses to look up X resources; for internal use only.
  852. `x-get-resource' uses this as the first component of the instance name
  853. when requesting resource values.
  854. Emacs initially sets `x-resource-name' to the name under which Emacs
  855. was invoked, or to the value specified with the `-name' or `-rn'
  856. switches, if present.Vx-nontext-pointer-shape
  857. The shape of the pointer when not over text.Vx-mode-pointer-shape
  858. The shape of the pointer when over the mode line.Vx-cursor-fore-pixel
  859. A string indicating the foreground color of the cursor box.Vmouse-grabbed
  860. Non-nil if a mouse button is currently depressed.Vx-no-window-manager
  861. t if no X window manager is in use.Fframe-face-alist
  862.  
  863.  
  864. arguments: (frame)Fset-frame-face-alist
  865.  
  866.  
  867. arguments: (frame value)Fmake-face-internal
  868. Create face number FACE-ID on all frames.
  869.  
  870. arguments: (face-id)Fset-face-attribute-internal
  871.  
  872.  
  873. arguments: (face-id attr-name attr-value frame)Finternal-next-face-id
  874.  
  875.  
  876. arguments: ()Vregion-face
  877. Face number to use to highlight the region
  878. The region is highlighted with this face
  879. when Transient Mark mode is enabled and the mark is active.Fx-popup-menu
  880. Pop up a deck-of-cards menu and return user's selection.
  881. POSITION is a position specification.  This is either a mouse button event
  882. or a list ((XOFFSET YOFFSET) WINDOW)
  883. where XOFFSET and YOFFSET are positions in characters from the top left
  884. corner of WINDOW's frame.  (WINDOW may be a frame object instead of a window.)
  885. This controls the position of the center of the first line
  886. in the first pane of the menu, not the top left of the menu as a whole.
  887.  
  888. MENU is a specifier for a menu.  For the simplest case, MENU is a keymap.
  889. The menu items come from key bindings that have a menu string as well as
  890. a definition; actually, the "definition" in such a key binding looks like
  891. (STRING . REAL-DEFINITION).  To give the menu a title, put a string into
  892. the keymap as a top-level element.
  893.  
  894. You can also use a list of keymaps as MENU.
  895.   Then each keymap makes a separate pane.
  896. When MENU is a keymap or a list of keymaps, the return value
  897. is a list of events.
  898.  
  899. Alternatively, you can specify a menu of multiple panes
  900.   with a list of the form (TITLE PANE1 PANE2...),
  901. where each pane is a list of form (TITLE ITEM1 ITEM2...).
  902. Each ITEM is normally a cons cell (STRING . VALUE);
  903. but a string can appear as an item--that makes a nonselectable line
  904. in the menu.
  905. With this form of menu, the return value is VALUE from the chosen item.
  906.  
  907. arguments: (position &optional menu)Fx-own-selection-internal
  908. Assert an X selection of the given TYPE with the given VALUE.
  909. TYPE is a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'.
  910. (Those are literal upper-case symbol names, since that's what X expects.)
  911. VALUE is typically a string, or a cons of two markers, but may be
  912. anything that the functions on `selection-converter-alist' know about.
  913.  
  914. arguments: (selection-name selection-value)Fx-get-selection-internal
  915. Return text selected from some X window.
  916. SELECTION is a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'.
  917. (Those are literal upper-case symbol names, since that's what X expects.)
  918. TYPE is the type of data desired, typically `STRING'.
  919.  
  920. arguments: (selection-symbol target-type)Fx-disown-selection-internal
  921. If we own the selection SELECTION, disown it.
  922. Disowning it means there is no such selection.
  923.  
  924. arguments: (selection &optional time)Fx-selection-owner-p
  925. Whether the current Emacs process owns the given X Selection.
  926. The arg should be the name of the selection in question, typically one of
  927. the symbols `PRIMARY', `SECONDARY', or `CLIPBOARD'.
  928. (Those are literal upper-case symbol names, since that's what X expects.)
  929. For convenience, the symbol nil is the same as `PRIMARY',
  930. and t is the same as `SECONDARY'.)
  931.  
  932. arguments: (&optional selection)Fx-selection-exists-p
  933. Whether there is an owner for the given X Selection.
  934. The arg should be the name of the selection in question, typically one of
  935. the symbols `PRIMARY', `SECONDARY', or `CLIPBOARD'.
  936. (Those are literal upper-case symbol names, since that's what X expects.)
  937. For convenience, the symbol nil is the same as `PRIMARY',
  938. and t is the same as `SECONDARY'.)
  939.  
  940. arguments: (&optional selection)Fx-get-cut-buffer-internal
  941. Returns the value of the named cut buffer (typically CUT_BUFFER0).
  942.  
  943. arguments: (buffer)Fx-store-cut-buffer-internal
  944. Sets the value of the named cut buffer (typically CUT_BUFFER0).
  945.  
  946. arguments: (buffer string)Fx-rotate-cut-buffers-internal
  947. Rotate the values of the cut buffers by the given number of steps;
  948. positive means move values forward, negative means backward.
  949.  
  950. arguments: (n)Vselection-converter-alist
  951. An alist associating X Windows selection-types with functions.
  952. These functions are called to convert the selection, with three args:
  953. the name of the selection (typically `PRIMARY', `SECONDARY', or `CLIPBOARD');
  954. a desired type to which the selection should be converted;
  955. and the local selection value (whatever was given to `x-own-selection').
  956.  
  957. The function should return the value to send to the X server
  958. (typically a string).  A return value of nil
  959. means that the conversion could not be done.
  960. A return value which is the symbol `NULL'
  961. means that a side-effect was executed,
  962. and there is no meaningful selection value.Vx-lost-selection-hooks
  963. A list of functions to be called when Emacs loses an X selection.
  964. (This happens when some other X client makes its own selection
  965. or when a Lisp program explicitly clears the selection.)
  966. The functions are called with one argument, the selection type
  967. (a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'.)Vx-sent-selection-hooks
  968. A list of functions to be called when Emacs answers a selection request.
  969. The functions are called with four arguments:
  970.   - the selection name (typically `PRIMARY', `SECONDARY', or `CLIPBOARD');
  971.   - the selection-type which Emacs was asked to convert the
  972.     selection into before sending (for example, `STRING' or `LENGTH');
  973.   - a flag indicating success or failure for responding to the request.
  974. We might have failed (and declined the request) for any number of reasons,
  975. including being asked for a selection that we no longer own, or being asked
  976. to convert into a type that we don't know about or that is inappropriate.
  977. This hook doesn't let you change the behavior of Emacs's selection replies,
  978. it merely informs you that they have happened.Vx-selection-timeout
  979. Number of milliseconds to wait for a selection reply.
  980. If the selection owner doens't reply in this time, we give up.
  981. A value of 0 means wait as long as necessary.  This is initialized from the
  982. "*selectionTimeout" resource.Finvocation-name
  983. Return the program name that was used to run Emacs.
  984. Any directory names are omitted.
  985.  
  986. arguments: ()Finvocation-directory
  987. Return the directory name in which the Emacs executable was located
  988.  
  989. arguments: ()Fkill-emacs
  990. Exit the Emacs job and kill it.
  991. If ARG is an integer, return ARG as the exit program code.
  992. If ARG is a  string, stuff it as keyboard input.
  993.  
  994. The value of `kill-emacs-hook', if not void,
  995. is a list of functions (of no args),
  996. all of which are called before Emacs is actually killed.
  997.  
  998. arguments: (&optional arg)Fdump-emacs-data
  999. Dump current state of Emacs into data file FILENAME.
  1000. This function exists on systems that use HAVE_SHM.
  1001.  
  1002. arguments: (intoname)Fdump-emacs
  1003. Dump current state of Emacs into executable file FILENAME.
  1004. Take symbols from SYMFILE (presumably the file you executed to run Emacs).
  1005. This is used in the file `loadup.el' when building Emacs.
  1006.  
  1007. Bind `command-line-processed' to nil before dumping,
  1008. if you want the dumped Emacs to process its command line
  1009. and announce itself normally when it is run.
  1010.  
  1011. arguments: (intoname symname)Vcommand-line-args
  1012. Args passed by shell to Emacs, as a list of strings.Vsystem-type
  1013. Value is symbol indicating type of operating system you are using.Vnoninteractive
  1014. Non-nil means Emacs is running without interactive terminal.Vkill-emacs-hook
  1015. Hook to be run whenever kill-emacs is called.
  1016. Since kill-emacs may be invoked when the terminal is disconnected (or
  1017. in other similar situations), functions placed on this hook should not
  1018. expect to be able to interact with the user.Vemacs-priority
  1019. Priority for Emacs to run at.
  1020. This value is effective only if set before Emacs is dumped,
  1021. and only if the Emacs executable is installed with setuid to permit
  1022. it to change priority.  (Emacs sets its uid back to the real uid.)Frecursive-edit
  1023. Invoke the editor command loop recursively.
  1024. To get out of the recursive edit, a command can do `(throw 'exit nil)';
  1025. that tells this function to return.
  1026. Alternately, `(throw 'exit t)' makes this function signal an error.
  1027. This function is called by the editor initialization to begin editing.
  1028.  
  1029. arguments: ()Ftop-level
  1030. Exit all recursive editing levels.
  1031.  
  1032. arguments: ()Fexit-recursive-edit
  1033. Exit from the innermost recursive edit or minibuffer.
  1034.  
  1035. arguments: ()Fabort-recursive-edit
  1036. Abort the command that requested this recursive edit or minibuffer input.
  1037.  
  1038. arguments: ()Ftrack-mouse
  1039. Evaluate BODY with mouse movement events enabled.
  1040. Within a `track-mouse' form, mouse motion generates input events that
  1041. you can read with `read-event'.
  1042. Normally, mouse motion is ignored.Fread-key-sequence
  1043. Read a sequence of keystrokes and return as a string or vector.
  1044. The sequence is sufficient to specify a non-prefix command in the
  1045. current local and global maps.
  1046.  
  1047. First arg PROMPT is a prompt string.  If nil, do not prompt specially.
  1048. Second (optional) arg CONTINUE-ECHO, if non-nil, means this key echos
  1049. as a continuation of the previous key.
  1050.  
  1051. A C-g typed while in this function is treated like any other character,
  1052. and `quit-flag' is not set.
  1053.  
  1054. If the key sequence starts with a mouse click, then the sequence is read
  1055. using the keymaps of the buffer of the window clicked in, not the buffer
  1056. of the selected window as normal.
  1057.  
  1058. `read-key-sequence' drops unbound button-down events, since you normally
  1059. only care about the click or drag events which follow them.  If a drag
  1060. or multi-click event is unbound, but the corresponding click event would
  1061. be bound, `read-key-sequence' turns the event into a click event at the
  1062. drag's starting position.  This means that you don't have to distinguish
  1063. between click and drag, double, or triple events unless you want to.
  1064.  
  1065. `read-key-sequence' prefixes mouse events on mode lines, the vertical
  1066. lines separating windows, and scroll bars with imaginary keys
  1067. `mode-line', `vertical-line', and `vertical-scroll-bar'.
  1068.  
  1069. If the user switches frames in the middle of a key sequence, the
  1070. frame-switch event is put off until after the current key sequence.
  1071.  
  1072. `read-key-sequence' checks `function-key-map' for function key
  1073. sequences, where they wouldn't conflict with ordinary bindings.  See
  1074. `function-key-map' for more details.
  1075.  
  1076. arguments: (prompt &optional continue-echo)Fcommand-execute
  1077. Execute CMD as an editor command.
  1078. CMD must be a symbol that satisfies the `commandp' predicate.
  1079. Optional second arg RECORD-FLAG non-nil
  1080. means unconditionally put this command in `command-history'.
  1081. Otherwise, that is done only if an arg is read using the minibuffer.
  1082.  
  1083. arguments: (cmd &optional record)Fexecute-extended-command
  1084. Read function name, then read its arguments and call it.
  1085.  
  1086. arguments: (prefixarg)Finput-pending-p
  1087. T if command input is currently available with no waiting.
  1088. Actually, the value is nil only if we can be sure that no input is available.
  1089.  
  1090. arguments: ()Frecent-keys
  1091. Return vector of last 100 events, not counting those from keyboard macros.
  1092.  
  1093. arguments: ()Fthis-command-keys
  1094. Return the key sequence that invoked this command.
  1095. The value is a string or a vector.
  1096.  
  1097. arguments: ()Frecursion-depth
  1098. Return the current depth in recursive edits.
  1099.  
  1100. arguments: ()Fopen-dribble-file
  1101. Start writing all keyboard characters to a dribble file called FILE.
  1102. If FILE is nil, close any open dribble file.
  1103.  
  1104. arguments: (file)Fdiscard-input
  1105. Discard the contents of the terminal input buffer.
  1106. Also cancel any kbd macro being defined.
  1107.  
  1108. arguments: ()Fsuspend-emacs
  1109. Stop Emacs and return to superior process.  You can resume later.
  1110. On systems that don't have job control, run a subshell instead.
  1111.  
  1112. If optional arg STUFFSTRING is non-nil, its characters are stuffed
  1113. to be read as terminal input by Emacs's parent, after suspension.
  1114.  
  1115. Before suspending, call the functions in `suspend-hook' with no args.
  1116. If any of them returns nil, don't call the rest and don't suspend.
  1117. Otherwise, suspend normally and after resumption run the normal hook
  1118. `suspend-resume-hook' if that is bound and non-nil.
  1119.  
  1120. Some operating systems cannot stop the Emacs process and resume it later.
  1121. On such systems, Emacs starts a subshell instead of suspending.
  1122.  
  1123. arguments: (&optional stuffstring)Fset-input-mode
  1124. Set mode of reading keyboard input.
  1125. First arg INTERRUPT non-nil means use input interrupts;
  1126.  nil means use CBREAK mode.
  1127. Second arg FLOW non-nil means use ^S/^Q flow control for output to terminal
  1128.  (no effect except in CBREAK mode).
  1129. Third arg META t means accept 8-bit input (for a Meta key).
  1130.  META nil means ignore the top bit, on the assumption it is parity.
  1131.  Otherwise, accept 8-bit input and don't use the top bit for Meta.
  1132. Optional fourth arg QUIT if non-nil specifies character to use for quitting.
  1133. See also `current-input-mode'.
  1134.  
  1135. arguments: (interrupt flow meta &optional quit)Fcurrent-input-mode
  1136. Return information about the way Emacs currently reads keyboard input.
  1137. The value is a list of the form (INTERRUPT FLOW META QUIT), where
  1138.   INTERRUPT is non-nil if Emacs is using interrupt-driven input; if
  1139.     nil, Emacs is using CBREAK mode.
  1140.   FLOW is non-nil if Emacs uses ^S/^Q flow control for output to the
  1141.     terminal; this does not apply if Emacs uses interrupt-driven input.
  1142.   META is t if accepting 8-bit input with 8th bit as Meta flag.
  1143.     META nil means ignoring the top bit, on the assumption it is parity.
  1144.     META is neither t nor nil if accepting 8-bit input and using
  1145.     all 8 bits as the character code.
  1146.   QUIT is the character Emacs currently uses to quit.
  1147. The elements of this list correspond to the arguments of
  1148. `set-input-mode'.
  1149.  
  1150. arguments: ()Vlast-command-char
  1151. Last input event that was part of a command.Vlast-command-event
  1152. Last input event that was part of a command.Vlast-nonmenu-event
  1153. Last input event in a command, except for mouse menu events.
  1154. Mouse menus give back keys that don't look like mouse events;
  1155. this variable holds the actual mouse event that led to the menu,
  1156. so that you can determine whether the command was run by mouse or not.Vlast-input-char
  1157. Last input event.Vlast-input-event
  1158. Last input event.Vunread-command-events
  1159. List of objects to be read as next command input events.Vunread-command-char
  1160. If not -1, an object to be read as next command input event.Vmeta-prefix-char
  1161. Meta-prefix character code.  Meta-foo as command input
  1162. turns into this character followed by foo.Vlast-command
  1163. The last command executed.  Normally a symbol with a function definition,
  1164. but can be whatever was found in the keymap, or whatever the variable
  1165. `this-command' was set to by that command.Vthis-command
  1166. The command now being executed.
  1167. The command can set this variable; whatever is put here
  1168. will be in `last-command' during the following command.Vauto-save-interval
  1169. *Number of keyboard input characters between auto-saves.
  1170. Zero means disable autosaving due to number of characters typed.Vauto-save-timeout
  1171. *Number of seconds idle time before auto-save.
  1172. Zero or nil means disable auto-saving due to idleness.
  1173. After auto-saving due to this many seconds of idle time,
  1174. Emacs also does a garbage collection if that seems to be warranted.Vecho-keystrokes
  1175. *Nonzero means echo unfinished commands after this many seconds of pause.Vpolling-period
  1176. *Interval between polling for input during Lisp execution.
  1177. The reason for polling is to make C-g work to stop a running program.
  1178. Polling is needed only when using X windows and SIGIO does not work.
  1179. Polling is automatically disabled in all other cases.Vdouble-click-time
  1180. *Maximum time between mouse clicks to make a double-click.
  1181. Measured in milliseconds.  nil means disable double-click recognition;
  1182. t means double-clicks have no time limit and are detected
  1183. by position only.Vnum-input-keys
  1184. *Number of complete keys read from the keyboard so far.Vlast-event-frame
  1185. *The frame in which the most recently read event occurred.
  1186. If the last event came from a keyboard macro, this is set to `macro'.Vhelp-char
  1187. Character to recognize as meaning Help.
  1188. When it is read, do `(eval help-form)', and display result if it's a string.
  1189. If the value of `help-form' is nil, this char can be read normally.Vhelp-form
  1190. Form to execute when character `help-char' is read.
  1191. If the form returns a string, that string is displayed.
  1192. If `help-form' is nil, the help char is not recognized.Vprefix-help-command
  1193. Command to run when `help-char' character follows a prefix key.
  1194. This command is used only when there is no actual binding
  1195. for that character after that prefix key.Vtop-level
  1196. Form to evaluate when Emacs starts up.
  1197. Useful to set before you dump a modified Emacs.Vkeyboard-translate-table
  1198. String used as translate table for keyboard input, or nil.
  1199. Each character is looked up in this string and the contents used instead.
  1200. If string is of length N, character codes N and up are untranslated.Vkey-translation-map
  1201. Keymap of key translations that can override keymaps.
  1202. This keymap works like `function-key-map', but comes after that,
  1203. and applies even for keys that have ordinary bindings.Vmenu-prompting
  1204. Non-nil means prompt with menus when appropriate.
  1205. This is done when reading from a keymap that has a prompt string,
  1206. for elements that have prompt strings.
  1207. The menu is displayed on the screen
  1208. if X menus were enabled at configuration
  1209. time and the previous event was a mouse click prefix key.
  1210. Otherwise, menu prompting uses the echo area.Vmenu-prompt-more-char
  1211. Character to see next line of menu prompt.
  1212. Type this character while in a menu prompt to rotate around the lines of it.Vextra-keyboard-modifiers
  1213. A mask of additional modifier keys to use with every keyboard character.
  1214. Emacs applies the modifiers of the character stored here to each keyboard
  1215. character it reads.  For example, after evaluating the expression
  1216.     (setq extra-keyboard-modifiers ?C-x)
  1217. all input characters will have the control modifier applied to them.
  1218.  
  1219. Note that the character ?C-@, equivalent to the integer zero, does
  1220. not count as a control character; rather, it counts as a character
  1221. with no modifiers; thus, setting `extra-keyboard-modifiers' to zero
  1222. cancels any modification.Vdeactivate-mark
  1223. If an editing command sets this to t, deactivate the mark afterward.
  1224. The command loop sets this to nil before each command,
  1225. and tests the value when the command returns.
  1226. Buffer modification stores t in this variable.Vpre-command-hook
  1227. Normal hook run before each command is executed.Vpost-command-hook
  1228. Normal hook run after each command is executed.Vlucid-menu-bar-dirty-flag
  1229. t means menu bar, specified Lucid style, needs to be recomputed.Vmenu-bar-final-items
  1230. List of menu bar items to move to the end of the menu bar.
  1231. The elements of the list are event types that may have menu bar bindings.Fstart-kbd-macro
  1232. Record subsequent keyboard input, defining a keyboard macro.
  1233. The commands are recorded even as they are executed.
  1234. Use \[end-kbd-macro] to finish recording and make the macro available.
  1235. Use \[name-last-kbd-macro] to give it a permanent name.
  1236. Non-nil arg (prefix arg) means append to last macro defined;
  1237.  This begins by re-executing that macro as if you typed it again.
  1238.  
  1239. arguments: (append)Fend-kbd-macro
  1240. Finish defining a keyboard macro.
  1241. The definition was started by \[start-kbd-macro].
  1242. The macro is now available for use via \[call-last-kbd-macro],
  1243. or it can be given a name with \[name-last-kbd-macro] and then invoked
  1244. under that name.
  1245.  
  1246. With numeric arg, repeat macro now that many times,
  1247. counting the definition just completed as the first repetition.
  1248. An argument of zero means repeat until error.
  1249.  
  1250. arguments: (&optional arg)Fcall-last-kbd-macro
  1251. Call the last keyboard macro that you defined with \[start-kbd-macro].
  1252.  
  1253. A prefix argument serves as a repeat count.  Zero means repeat until error.
  1254.  
  1255. To make a macro permanent so you can call it even after
  1256. defining others, use \[name-last-kbd-macro].
  1257.  
  1258. arguments: (&optional prefix)Fexecute-kbd-macro
  1259. Execute MACRO as string of editor command characters.
  1260. If MACRO is a symbol, its function definition is used.
  1261. COUNT is a repeat count, or nil for once, or 0 for infinite loop.
  1262.  
  1263. arguments: (macro &optional prefixarg)Vdefining-kbd-macro
  1264. Non-nil while a keyboard macro is being defined.  Don't set this!Vexecuting-macro
  1265. Currently executing keyboard macro (a string); nil if none executing.Vexecuting-kbd-macro
  1266. Currently executing keyboard macro (a string); nil if none executing.Vlast-kbd-macro
  1267. Last kbd macro defined, as a string; nil if none defined.Fmake-keymap
  1268. Construct and return a new keymap, of the form (keymap VECTOR . ALIST).
  1269. VECTOR is a vector which holds the bindings for the ASCII
  1270. characters.  ALIST is an assoc-list which holds bindings for function keys,
  1271. mouse events, and any other things that appear in the input stream.
  1272. All entries in it are initially nil, meaning "command undefined".
  1273.  
  1274. The optional arg STRING supplies a menu name for the keymap
  1275. in case you use it as a menu with `x-popup-menu'.
  1276.  
  1277. arguments: (&optional string)Fmake-sparse-keymap
  1278. Construct and return a new sparse-keymap list.
  1279. Its car is `keymap' and its cdr is an alist of (CHAR . DEFINITION),
  1280. which binds the character CHAR to DEFINITION, or (SYMBOL . DEFINITION),
  1281. which binds the function key or mouse event SYMBOL to DEFINITION.
  1282. Initially the alist is nil.
  1283.  
  1284. The optional arg STRING supplies a menu name for the keymap
  1285. in case you use it as a menu with `x-popup-menu'.
  1286.  
  1287. arguments: (&optional string)Fkeymapp
  1288. Return t if ARG is a keymap.
  1289.  
  1290. A keymap is a list (keymap . ALIST),
  1291. or a symbol whose function definition is a keymap is itself a keymap.
  1292. ALIST elements look like (CHAR . DEFN) or (SYMBOL . DEFN);
  1293. a vector of densely packed bindings for small character codes
  1294. is also allowed as an element.
  1295.  
  1296. arguments: (object)Fcopy-keymap
  1297. Return a copy of the keymap KEYMAP.
  1298. The copy starts out with the same definitions of KEYMAP,
  1299. but changing either the copy or KEYMAP does not affect the other.
  1300. Any key definitions that are subkeymaps are recursively copied.
  1301. However, a key definition which is a symbol whose definition is a keymap
  1302. is not copied.
  1303.  
  1304. arguments: (keymap)Fdefine-key
  1305. Args KEYMAP, KEY, DEF.  Define key sequence KEY, in KEYMAP, as DEF.
  1306. KEYMAP is a keymap.  KEY is a string or a vector of symbols and characters
  1307. meaning a sequence of keystrokes and events.
  1308. Non-ASCII characters with codes above 127 (such as ISO Latin-1)
  1309. can be included if you use a vector.
  1310. DEF is anything that can be a key's definition:
  1311.  nil (means key is undefined in this keymap),
  1312.  a command (a Lisp function suitable for interactive calling)
  1313.  a string (treated as a keyboard macro),
  1314.  a keymap (to define a prefix key),
  1315.  a symbol.  When the key is looked up, the symbol will stand for its
  1316.     function definition, which should at that time be one of the above,
  1317.     or another symbol whose function definition is used, etc.
  1318.  a cons (STRING . DEFN), meaning that DEFN is the definition
  1319.     (DEFN should be a valid definition in its own right),
  1320.  or a cons (KEYMAP . CHAR), meaning use definition of CHAR in map KEYMAP.
  1321.  
  1322. If KEYMAP is a sparse keymap, the pair binding KEY to DEF is added at
  1323. the front of KEYMAP.
  1324.  
  1325. arguments: (keymap key def)Flookup-key
  1326. In keymap KEYMAP, look up key sequence KEY.  Return the definition.
  1327. nil means undefined.  See doc of `define-key' for kinds of definitions.
  1328.  
  1329. A number as value means KEY is "too long";
  1330. that is, characters or symbols in it except for the last one
  1331. fail to be a valid sequence of prefix characters in KEYMAP.
  1332. The number is how many characters at the front of KEY
  1333. it takes to reach a non-prefix command.
  1334.  
  1335. Normally, `lookup-key' ignores bindings for t, which act as default
  1336. bindings, used when nothing else in the keymap applies; this makes it
  1337. useable as a general function for probing keymaps.  However, if the
  1338. third optional argument ACCEPT-DEFAULT is non-nil, `lookup-key' will
  1339. recognize the default bindings, just as `read-key-sequence' does.
  1340.  
  1341. arguments: (keymap key &optional accept-default)Fkey-binding
  1342. Return the binding for command KEY in current keymaps.
  1343. KEY is a string or vector, a sequence of keystrokes.
  1344. The binding is probably a symbol with a function definition.
  1345.  
  1346. Normally, `key-binding' ignores bindings for t, which act as default
  1347. bindings, used when nothing else in the keymap applies; this makes it
  1348. usable as a general function for probing keymaps.  However, if the
  1349. optional second argument ACCEPT-DEFAULT is non-nil, `key-binding' does
  1350. recognize the default bindings, just as `read-key-sequence' does.
  1351.  
  1352. arguments: (key &optional accept-default)Flocal-key-binding
  1353. Return the binding for command KEYS in current local keymap only.
  1354. KEYS is a string, a sequence of keystrokes.
  1355. The binding is probably a symbol with a function definition.
  1356.  
  1357. If optional argument ACCEPT-DEFAULT is non-nil, recognize default
  1358. bindings; see the description of `lookup-key' for more details about this.
  1359.  
  1360. arguments: (keys &optional accept-default)Fglobal-key-binding
  1361. Return the binding for command KEYS in current global keymap only.
  1362. KEYS is a string, a sequence of keystrokes.
  1363. The binding is probably a symbol with a function definition.
  1364. This function's return values are the same as those of lookup-key
  1365. (which see).
  1366.  
  1367. If optional argument ACCEPT-DEFAULT is non-nil, recognize default
  1368. bindings; see the description of `lookup-key' for more details about this.
  1369.  
  1370. arguments: (keys &optional accept-default)Fminor-mode-key-binding
  1371. Find the visible minor mode bindings of KEY.
  1372. Return an alist of pairs (MODENAME . BINDING), where MODENAME is the
  1373. the symbol which names the minor mode binding KEY, and BINDING is
  1374. KEY's definition in that mode.  In particular, if KEY has no
  1375. minor-mode bindings, return nil.  If the first binding is a
  1376. non-prefix, all subsequent bindings will be omitted, since they would
  1377. be ignored.  Similarly, the list doesn't include non-prefix bindings
  1378. that come after prefix bindings.
  1379.  
  1380. If optional argument ACCEPT-DEFAULT is non-nil, recognize default
  1381. bindings; see the description of `lookup-key' for more details about this.
  1382.  
  1383. arguments: (key &optional accept-default)Fglobal-set-key
  1384. Give KEY a global binding as COMMAND.
  1385. COMMAND is a symbol naming an interactively-callable function.
  1386. KEY is a key sequence (a string or vector of characters or event types).
  1387. Non-ASCII characters with codes above 127 (such as ISO Latin-1)
  1388. can be included if you use a vector.
  1389. Note that if KEY has a local binding in the current buffer
  1390. that local binding will continue to shadow any global binding.
  1391.  
  1392. arguments: (keys function)Flocal-set-key
  1393. Give KEY a local binding as COMMAND.
  1394. COMMAND is a symbol naming an interactively-callable function.
  1395. KEY is a key sequence (a string or vector of characters or event types).
  1396. Non-ASCII characters with codes above 127 (such as ISO Latin-1)
  1397. can be included if you use a vector.
  1398. The binding goes in the current buffer's local map,
  1399. which is shared with other buffers in the same major mode.
  1400.  
  1401. arguments: (keys function)Fglobal-unset-key
  1402. Remove global binding of KEY.
  1403. KEY is a string representing a sequence of keystrokes.
  1404.  
  1405. arguments: (keys)Flocal-unset-key
  1406. Remove local binding of KEY.
  1407. KEY is a string representing a sequence of keystrokes.
  1408.  
  1409. arguments: (keys)Fdefine-prefix-command
  1410. Define COMMAND as a prefix command.  COMMAND should be a symbol.
  1411. A new sparse keymap is stored as COMMAND's function definition and its value.
  1412. If a second optional argument MAPVAR is given, the map is stored as
  1413. its value instead of as COMMAND's value; but COMMAND is still defined
  1414. as a function.
  1415.  
  1416. arguments: (name &optional mapvar)Fuse-global-map
  1417. Select KEYMAP as the global keymap.
  1418.  
  1419. arguments: (keymap)Fuse-local-map
  1420. Select KEYMAP as the local keymap.
  1421. If KEYMAP is nil, that means no local keymap.
  1422.  
  1423. arguments: (keymap)Fcurrent-local-map
  1424. Return current buffer's local keymap, or nil if it has none.
  1425.  
  1426. arguments: ()Fcurrent-global-map
  1427. Return the current global keymap.
  1428.  
  1429. arguments: ()Fcurrent-minor-mode-maps
  1430. Return a list of keymaps for the minor modes of the current buffer.
  1431.  
  1432. arguments: ()Faccessible-keymaps
  1433. Find all keymaps accessible via prefix characters from KEYMAP.
  1434. Returns a list of elements of the form (KEYS . MAP), where the sequence
  1435. KEYS starting from KEYMAP gets you to MAP.  These elements are ordered
  1436. so that the KEYS increase in length.  The first element is ("" . KEYMAP).
  1437. An optional argument PREFIX, if non-nil, should be a key sequence;
  1438. then the value includes only maps for prefixes that start with PREFIX.
  1439.  
  1440. arguments: (startmap &optional prefix)Fkey-description
  1441. Return a pretty description of key-sequence KEYS.
  1442. Control characters turn into "C-foo" sequences, meta into "M-foo"
  1443. spaces are put between sequence elements, etc.
  1444.  
  1445. arguments: (keys)Fsingle-key-description
  1446. Return a pretty description of command character KEY.
  1447. Control characters turn into C-whatever, etc.
  1448.  
  1449. arguments: (key)Ftext-char-description
  1450. Return a pretty description of file-character CHAR.
  1451. Control characters turn into "^char", etc.
  1452.  
  1453. arguments: (chr)Fwhere-is-internal
  1454. Return list of keys that invoke DEFINITION in KEYMAP or KEYMAP1.
  1455. If KEYMAP is nil, search only KEYMAP1.
  1456. If KEYMAP1 is nil, use the current global map.
  1457.  
  1458. If optional 4th arg FIRSTONLY is non-nil, return a string representing
  1459. the first key sequence found, rather than a list of all possible key
  1460. sequences.  If FIRSTONLY is t, avoid key sequences which use non-ASCII
  1461. keys and therefore may not be usable on ASCII terminals.  If FIRSTONLY
  1462. is the symbol `non-ascii', return the first binding found, no matter
  1463. what its components.
  1464.  
  1465. If optional 5th arg NOINDIRECT is non-nil, don't follow indirections
  1466. to other keymaps or slots.  This makes it possible to search for an
  1467. indirect definition itself.
  1468.  
  1469. arguments: (definition &optional local-keymap global-keymap firstonly noindirect)Fwhere-is
  1470. Print message listing key sequences that invoke specified command.
  1471. Argument is a command definition, usually a symbol with a function definition.
  1472.  
  1473. arguments: (definition)Fdescribe-bindings
  1474. Show a list of all defined keys, and their definitions.
  1475. The list is put in a buffer, which is displayed.
  1476. An optional argument PREFIX, if non-nil, should be a key sequence;
  1477. then we display only bindings that start with that prefix.
  1478.  
  1479. arguments: (&optional prefix)Fdescribe-vector
  1480. Insert a description of contents of VECTOR.
  1481. This is text showing the elements of vector matched against indices.
  1482.  
  1483. arguments: (vector)Fapropos-internal
  1484. Show all symbols whose names contain match for REGEXP.
  1485. If optional 2nd arg PRED is non-nil, (funcall PRED SYM) is done
  1486. for each symbol and a symbol is mentioned only if that returns non-nil.
  1487. Return list of symbols found.
  1488.  
  1489. arguments: (string &optional pred)Vminibuffer-local-map
  1490. Default keymap to use when reading from the minibuffer.Vminibuffer-local-ns-map
  1491. Local keymap for the minibuffer when spaces are not allowed.Vminibuffer-local-completion-map
  1492. Local keymap for minibuffer input with completion.Vminibuffer-local-must-match-map
  1493. Local keymap for minibuffer input with completion, for exact match.Vminor-mode-map-alist
  1494. Alist of keymaps to use for minor modes.
  1495. Each element looks like (VARIABLE . KEYMAP); KEYMAP is used to read
  1496. key sequences and look up bindings iff VARIABLE's value is non-nil.
  1497. If two active keymaps bind the same key, the keymap appearing earlier
  1498. in the list takes precedence.Vfunction-key-map
  1499. Keymap mapping ASCII function key sequences onto their preferred forms.
  1500. This allows Emacs to recognize function keys sent from ASCII
  1501. terminals at any point in a key sequence.
  1502.  
  1503. The read-key-sequence function replaces subsequences bound by
  1504. function-key-map with their bindings.  When the current local and global
  1505. keymaps have no binding for the current key sequence but
  1506. function-key-map binds a suffix of the sequence to a vector or string,
  1507. read-key-sequence replaces the matching suffix with its binding, and
  1508. continues with the new sequence.
  1509.  
  1510. For example, suppose function-key-map binds `ESC O P' to [f1].
  1511. Typing `ESC O P' to read-key-sequence would return [f1].  Typing
  1512. `C-x ESC O P' would return [?\C-x f1].  If [f1] were a prefix
  1513. key, typing `ESC O P x' would return [f1 x].Fbuffer-list
  1514. Return a list of all existing live buffers.
  1515.  
  1516. arguments: ()Fget-buffer
  1517. Return the buffer named NAME (a string).
  1518. If there is no live buffer named NAME, return nil.
  1519. NAME may also be a buffer; if so, the value is that buffer.
  1520.  
  1521. arguments: (name)Fget-file-buffer
  1522. Return the buffer visiting file FILENAME (a string).
  1523. If there is no such live buffer, return nil.
  1524.  
  1525. arguments: (filename)Fget-buffer-create
  1526. Return the buffer named NAME, or create such a buffer and return it.
  1527. A new buffer is created if there is no live buffer named NAME.
  1528. If NAME starts with a space, the new buffer does not keep undo information.
  1529. If NAME is a buffer instead of a string, then it is the value returned.
  1530. The value is never nil.
  1531.  
  1532. arguments: (name)Fgenerate-new-buffer-name
  1533. Return a string that is the name of no existing buffer based on NAME.
  1534. If there is no live buffer named NAME, then return NAME.
  1535. Otherwise modify name by appending `<NUMBER>', incrementing NUMBER
  1536. until an unused name is found, and then return that name.
  1537. Optional second argument IGNORE specifies a name that is okay to use
  1538. (if it is in the sequence to be tried)
  1539. even if a buffer with that name exists.
  1540.  
  1541. arguments: (name &optional ignore)Fbuffer-name
  1542. Return the name of BUFFER, as a string.
  1543. With no argument or nil as argument, return the name of the current buffer.
  1544.  
  1545. arguments: (&optional buffer)Fbuffer-file-name
  1546. Return name of file BUFFER is visiting, or nil if none.
  1547. No argument or nil as argument means use the current buffer.
  1548.  
  1549. arguments: (&optional buffer)Fbuffer-local-variables
  1550. Return an alist of variables that are buffer-local in BUFFER.
  1551. Most elements look like (SYMBOL . VALUE), describing one variable.
  1552. For a symbol that is locally unbound, just the symbol appears in the value.
  1553. Note that storing new VALUEs in these elements doesn't change the variables.
  1554. No argument or nil as argument means use current buffer as BUFFER.
  1555.  
  1556. arguments: (&optional buffer)Fbuffer-modified-p
  1557. Return t if BUFFER was modified since its file was last read or saved.
  1558. No argument or nil as argument means use current buffer as BUFFER.
  1559.  
  1560. arguments: (&optional buffer)Fset-buffer-modified-p
  1561. Mark current buffer as modified or unmodified according to FLAG.
  1562. A non-nil FLAG means mark the buffer modified.
  1563.  
  1564. arguments: (flag)Fbuffer-modified-tick
  1565. Return BUFFER's tick counter, incremented for each change in text.
  1566. Each buffer has a tick counter which is incremented each time the text in
  1567. that buffer is changed.  It wraps around occasionally.
  1568. No argument or nil as argument means use current buffer as BUFFER.
  1569.  
  1570. arguments: (&optional buffer)Frename-buffer
  1571. Change current buffer's name to NEWNAME (a string).
  1572. If second arg UNIQUE is nil or omitted, it is an error if a
  1573. buffer named NEWNAME already exists.
  1574. If UNIQUE is non-nil, come up with a new name using
  1575. `generate-new-buffer-name'.
  1576. Interactively, you can set UNIQUE with a prefix argument.
  1577. We return the name we actually gave the buffer.
  1578. This does not change the name of the visited file (if any).
  1579.  
  1580. arguments: (name &optional unique)Fother-buffer
  1581. Return most recently selected buffer other than BUFFER.
  1582. Buffers not visible in windows are preferred to visible buffers,
  1583. unless optional second argument VISIBLE-OK is non-nil.
  1584. If no other buffer exists, the buffer `*scratch*' is returned.
  1585. If BUFFER is omitted or nil, some interesting buffer is returned.
  1586.  
  1587. arguments: (&optional buffer visible-ok)Fbuffer-disable-undo
  1588. Make BUFFER stop keeping undo information.
  1589.  
  1590. arguments: (buffer)Fbuffer-enable-undo
  1591. Start keeping undo information for buffer BUFFER.
  1592. No argument or nil as argument means do this for the current buffer.
  1593.  
  1594. arguments: (&optional buffer)Vkill-buffer-hook
  1595. Hook to be run (by `run-hooks', which see) when a buffer is killed.
  1596. The buffer being killed will be current while the hook is running.
  1597. See `kill-buffer'.Fkill-buffer
  1598. Kill the buffer BUFFER.
  1599. The argument may be a buffer or may be the name of a buffer.
  1600. An argument of nil means kill the current buffer.
  1601.  
  1602. Value is t if the buffer is actually killed, nil if user says no.
  1603.  
  1604. The value of `kill-buffer-hook' (which may be local to that buffer),
  1605. if not void, is a list of functions to be called, with no arguments,
  1606. before the buffer is actually killed.  The buffer to be killed is current
  1607. when the hook functions are called.
  1608.  
  1609. Any processes that have this buffer as the `process-buffer' are killed
  1610. with `delete-process'.
  1611.  
  1612. arguments: (bufname)Fswitch-to-buffer
  1613. Select buffer BUFFER in the current window.
  1614. BUFFER may be a buffer or a buffer name.
  1615. Optional second arg NORECORD non-nil means
  1616. do not put this buffer at the front of the list of recently selected ones.
  1617.  
  1618. WARNING: This is NOT the way to work on another buffer temporarily
  1619. within a Lisp program!  Use `set-buffer' instead.  That avoids messing with
  1620. the window-buffer correspondences.
  1621.  
  1622. arguments: (bufname &optional norecord)Fpop-to-buffer
  1623. Select buffer BUFFER in some window, preferably a different one.
  1624. If BUFFER is nil, then some other buffer is chosen.
  1625. If `pop-up-windows' is non-nil, windows can be split to do this.
  1626. If optional second arg OTHER-WINDOW is non-nil, insist on finding another
  1627. window even if BUFFER is already visible in the selected window.
  1628.  
  1629. arguments: (bufname &optional other)Fcurrent-buffer
  1630. Return the current buffer as a Lisp object.
  1631.  
  1632. arguments: ()Fset-buffer
  1633. Make the buffer BUFFER current for editing operations.
  1634. BUFFER may be a buffer or the name of an existing buffer.
  1635. See also `save-excursion' when you want to make a buffer current temporarily.
  1636. This function does not display the buffer, so its effect ends
  1637. when the current command terminates.
  1638. Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.
  1639.  
  1640. arguments: (bufname)Fbarf-if-buffer-read-only
  1641. Signal a `buffer-read-only' error if the current buffer is read-only.
  1642.  
  1643. arguments: ()Fbury-buffer
  1644. Put BUFFER at the end of the list of all buffers.
  1645. There it is the least likely candidate for `other-buffer' to return;
  1646. thus, the least likely buffer for \[switch-to-buffer] to select by default.
  1647. If BUFFER is nil or omitted, bury the current buffer.
  1648. Also, if BUFFER is nil or omitted, remove the current buffer from the
  1649. selected window if it is displayed there.
  1650.  
  1651. arguments: (&optional buf)Ferase-buffer
  1652. Delete the entire contents of the current buffer.
  1653. Any narrowing restriction in effect (see `narrow-to-region') is removed,
  1654. so the buffer is truly empty after this.
  1655.  
  1656. arguments: ()Flist-buffers
  1657. Display a list of names of existing buffers.
  1658. The list is displayed in a buffer named `*Buffer List*'.
  1659. Note that buffers with names starting with spaces are omitted.
  1660. Non-null optional arg FILES-ONLY means mention only file buffers.
  1661.  
  1662. The M column contains a * for buffers that are modified.
  1663. The R column contains a % for buffers that are read-only.
  1664.  
  1665. arguments: (&optional files)Fkill-all-local-variables
  1666. Switch to Fundamental mode by killing current buffer's local variables.
  1667. Most local variable bindings are eliminated so that the default values
  1668. become effective once more.  Also, the syntax table is set from
  1669. `standard-syntax-table', the local keymap is set to nil,
  1670. and the abbrev table from `fundamental-mode-abbrev-table'.
  1671. This function also forces redisplay of the mode line.
  1672.  
  1673. Every function to select a new major mode starts by
  1674. calling this function.
  1675.  
  1676. As a special exception, local variables whose names have
  1677. a non-nil `permanent-local' property are not eliminated by this function.
  1678.  
  1679. arguments: ()Foverlayp
  1680. Return t if OBJECT is an overlay.
  1681.  
  1682. arguments: (object)Fmake-overlay
  1683. Create a new overlay with range BEG to END in BUFFER.
  1684. If omitted, BUFFER defaults to the current buffer.
  1685. BEG and END may be integers or markers.
  1686.  
  1687. arguments: (beg end &optional buffer)Fmove-overlay
  1688. Set the endpoints of OVERLAY to BEG and END in BUFFER.
  1689. If BUFFER is omitted, leave OVERLAY in the same buffer it inhabits now.
  1690. If BUFFER is omitted, and OVERLAY is in no buffer, put it in the current
  1691. buffer.
  1692.  
  1693. arguments: (overlay beg end &optional buffer)Fdelete-overlay
  1694. Delete the overlay OVERLAY from its buffer.
  1695.  
  1696. arguments: (overlay)Foverlay-start
  1697. Return the position at which OVERLAY starts.
  1698.  
  1699. arguments: (overlay)Foverlay-end
  1700. Return the position at which OVERLAY ends.
  1701.  
  1702. arguments: (overlay)Foverlay-buffer
  1703. Return the buffer OVERLAY belongs to.
  1704.  
  1705. arguments: (overlay)Foverlay-properties
  1706. Return a list of the properties on OVERLAY.
  1707. This is a copy of OVERLAY's plist; modifying its conses has no effect on
  1708. OVERLAY.
  1709.  
  1710. arguments: (overlay)Foverlays-at
  1711. Return a list of the overlays that contain position POS.
  1712.  
  1713. arguments: (pos)Fnext-overlay-change
  1714. Return the next position after POS where an overlay starts or ends.
  1715.  
  1716. arguments: (pos)Foverlay-lists
  1717. Return a pair of lists giving all the overlays of the current buffer.
  1718. The car has all the overlays before the overlay center;
  1719. the cdr has all the overlays before the overlay center.
  1720. Recentering overlays moves overlays between these lists.
  1721. The lists you get are copies, so that changing them has no effect.
  1722. However, the overlays you get are the real objects that the buffer uses.
  1723.  
  1724. arguments: ()Foverlay-recenter
  1725. Recenter the overlays of the current buffer around position POS.
  1726.  
  1727. arguments: (pos)Foverlay-get
  1728. Get the property of overlay OVERLAY with property name NAME.
  1729.  
  1730. arguments: (overlay prop)Foverlay-put
  1731. Set one property of overlay OVERLAY: give property PROP value VALUE.
  1732.  
  1733. arguments: (overlay prop value)Vdefault-mode-line-format
  1734. Default value of `mode-line-format' for buffers that don't override it.
  1735. This is the same as (default-value 'mode-line-format).Vdefault-abbrev-mode
  1736. Default value of `abbrev-mode' for buffers that do not override it.
  1737. This is the same as (default-value 'abbrev-mode).Vdefault-ctl-arrow
  1738. Default value of `ctl-arrow' for buffers that do not override it.
  1739. This is the same as (default-value 'ctl-arrow).Vdefault-truncate-lines
  1740. Default value of `truncate-lines' for buffers that do not override it.
  1741. This is the same as (default-value 'truncate-lines).Vdefault-fill-column
  1742. Default value of `fill-column' for buffers that do not override it.
  1743. This is the same as (default-value 'fill-column).Vdefault-left-margin
  1744. Default value of `left-margin' for buffers that do not override it.
  1745. This is the same as (default-value 'left-margin).Vdefault-tab-width
  1746. Default value of `tab-width' for buffers that do not override it.
  1747. This is the same as (default-value 'tab-width).Vdefault-case-fold-search
  1748. Default value of `case-fold-search' for buffers that don't override it.
  1749. This is the same as (default-value 'case-fold-search).Vmode-line-format
  1750. Template for displaying mode line for current buffer.
  1751. Each buffer has its own value of this variable.
  1752. Value may be a string, a symbol or a list or cons cell.
  1753. For a symbol, its value is used (but it is ignored if t or nil).
  1754.  A string appearing directly as the value of a symbol is processed verbatim
  1755.  in that the %-constructs below are not recognized.
  1756. For a list whose car is a symbol, the symbol's value is taken,
  1757.  and if that is non-nil, the cadr of the list is processed recursively.
  1758.  Otherwise, the caddr of the list (if there is one) is processed.
  1759. For a list whose car is a string or list, each element is processed
  1760.  recursively and the results are effectively concatenated.
  1761. For a list whose car is an integer, the cdr of the list is processed
  1762.   and padded (if the number is positive) or truncated (if negative)
  1763.   to the width specified by that number.
  1764. A string is printed verbatim in the mode line except for %-constructs:
  1765.   (%-constructs are allowed when the string is the entire mode-line-format
  1766.    or when it is found in a cons-cell or a list)
  1767.   %b -- print buffer name.      %f -- print visited file name.
  1768.   %* -- print *, % or hyphen.   %m -- print value of mode-name (obsolete).
  1769.   %s -- print process status.   %l -- print the current line number.
  1770.   %p -- print percent of buffer above top of window, or top, bot or all.
  1771.   %n -- print Narrow if appropriate.
  1772.   %[ -- print one [ for each recursive editing level.  %] similar.
  1773.   %% -- print %.   %- -- print infinitely many dashes.
  1774. Decimal digits after the % specify field width to which to pad.Vdefault-major-mode
  1775. *Major mode for new buffers.  Defaults to `fundamental-mode'.
  1776. nil here means use current buffer's major mode.Vmajor-mode
  1777. Symbol for current buffer's major mode.Vmode-name
  1778. Pretty name of current buffer's major mode (a string).Vabbrev-mode
  1779. Non-nil turns on automatic expansion of abbrevs as they are inserted.
  1780. Automatically becomes buffer-local when set in any fashion.Vcase-fold-search
  1781. *Non-nil if searches should ignore case.
  1782. Automatically becomes buffer-local when set in any fashion.Vfill-column
  1783. *Column beyond which automatic line-wrapping should happen.
  1784. Automatically becomes buffer-local when set in any fashion.Vleft-margin
  1785. *Column for the default indent-line-function to indent to.
  1786. Linefeed indents to this column in Fundamental mode.
  1787. Automatically becomes buffer-local when set in any fashion.Vtab-width
  1788. *Distance between tab stops (for display of tab characters), in columns.
  1789. Automatically becomes buffer-local when set in any fashion.Vctl-arrow
  1790. *Non-nil means display control chars with uparrow.
  1791. Nil means use backslash and octal digits.
  1792. Automatically becomes buffer-local when set in any fashion.
  1793. This variable does not apply to characters whose display is specified
  1794. in the current display table (if there is one).Vtruncate-lines
  1795. *Non-nil means do not display continuation lines;
  1796. give each line of text one screen line.
  1797. Automatically becomes buffer-local when set in any fashion.
  1798.  
  1799. Note that this is overridden by the variable
  1800. `truncate-partial-width-windows' if that variable is non-nil
  1801. and this buffer is not full-frame width.Vdefault-directory
  1802. Name of default directory of current buffer.  Should end with slash.
  1803. Each buffer has its own value of this variable.Vauto-fill-function
  1804. Function called (if non-nil) to perform auto-fill.
  1805. It is called after self-inserting a space at a column beyond `fill-column'.
  1806. Each buffer has its own value of this variable.
  1807. NOTE: This variable is not an ordinary hook;
  1808. It may not be a list of functions.Vbuffer-file-name
  1809. Name of file visited in current buffer, or nil if not visiting a file.
  1810. Each buffer has its own value of this variable.Vbuffer-auto-save-file-name
  1811. Name of file for auto-saving current buffer,
  1812. or nil if buffer should not be auto-saved.
  1813. Each buffer has its own value of this variable.Vbuffer-read-only
  1814. Non-nil if this buffer is read-only.
  1815. Each buffer has its own value of this variable.Vbuffer-backed-up
  1816. Non-nil if this buffer's file has been backed up.
  1817. Backing up is done before the first time the file is saved.
  1818. Each buffer has its own value of this variable.Vbuffer-saved-size
  1819. Length of current buffer when last read in, saved or auto-saved.
  1820. 0 initially.
  1821. Each buffer has its own value of this variable.Vselective-display
  1822. Non-nil enables selective display:
  1823. Integer N as value means display only lines
  1824.  that start with less than n columns of space.
  1825. A value of t means, after a ^M, all the rest of the line is invisible.
  1826.  Then ^M's in the file are written into files as newlines.
  1827.  
  1828. Automatically becomes buffer-local when set in any fashion.Vselective-display-ellipses
  1829. t means display ... on previous line when a line is invisible.
  1830. Automatically becomes buffer-local when set in any fashion.Voverwrite-mode
  1831. Non-nil if self-insertion should replace existing text.
  1832. If non-nil and not `overwrite-mode-binary', self-insertion still
  1833. inserts at the end of a line, and inserts when point is before a tab,
  1834. until the tab is filled in.
  1835. If `overwrite-mode-binary', self-insertion replaces newlines and tabs too.
  1836. Automatically becomes buffer-local when set in any fashion.Vbuffer-display-table
  1837. Display table that controls display of the contents of current buffer.
  1838. Automatically becomes buffer-local when set in any fashion.
  1839. The display table is a vector created with `make-display-table'.
  1840. The first 256 elements control how to display each possible text character.
  1841. Each value should be a vector of characters or nil;
  1842. nil means display the character in the default fashion.
  1843. The remaining five elements control the display of
  1844.   the end of a truncated screen line (element 256, a single character);
  1845.   the end of a continued line (element 257, a single character);
  1846.   the escape character used to display character codes in octal
  1847.     (element 258, a single character);
  1848.   the character used as an arrow for control characters (element 259,
  1849.     a single character);
  1850.   the decoration indicating the presence of invisible lines (element 260,
  1851.     a vector of characters).
  1852. If this variable is nil, the value of `standard-display-table' is used.
  1853. Each window can have its own, overriding display table.Vbuffer-display-table
  1854. Vbefore-change-function
  1855. Function to call before each text change.
  1856. Two arguments are passed to the function: the positions of
  1857. the beginning and end of the range of old text to be changed.
  1858. (For an insertion, the beginning and end are at the same place.)
  1859. No information is given about the length of the text after the change.
  1860. position of the change
  1861.  
  1862. While executing the `before-change-function', changes to buffers do not
  1863. cause calls to any `before-change-function' or `after-change-function'.Vafter-change-function
  1864. Function to call after each text change.
  1865. Three arguments are passed to the function: the positions of
  1866. the beginning and end of the range of changed text,
  1867. and the length of the pre-change text replaced by that range.
  1868. (For an insertion, the pre-change length is zero;
  1869. for a deletion, that length is the number of characters deleted,
  1870. and the post-change beginning and end are at the same place.)
  1871.  
  1872. While executing the `after-change-function', changes to buffers do not
  1873. cause calls to any `before-change-function' or `after-change-function'.Vfirst-change-hook
  1874. A list of functions to call before changing a buffer which is unmodified.
  1875. The functions are run using the `run-hooks' function.Vbuffer-undo-list
  1876. List of undo entries in current buffer.
  1877. Recent changes come first; older changes follow newer.
  1878.  
  1879. An entry (START . END) represents an insertion which begins at
  1880. position START and ends at position END.
  1881.  
  1882. An entry (TEXT . POSITION) represents the deletion of the string TEXT
  1883. from (abs POSITION).  If POSITION is positive, point was at the front
  1884. of the text being deleted; if negative, point was at the end.
  1885.  
  1886. An entry (t HIGHWORD LOWWORD) indicates that the buffer had been
  1887. previously unmodified.  HIGHWORD and LOWWORD are the high and low
  1888. 16-bit words of the buffer's modification count at the time.  If the
  1889. modification count of the most recent save is different, this entry is
  1890. obsolete.
  1891.  
  1892. An entry (nil PROP VAL BEG . END) indicates that a text property
  1893. was modified between BEG and END.  PROP is the property name,
  1894. and VAL is the old value.
  1895.  
  1896. An entry of the form POSITION indicates that point was at the buffer
  1897. location given by the integer.  Undoing an entry of this form places
  1898. point at POSITION.
  1899.  
  1900. nil marks undo boundaries.  The undo command treats the changes
  1901. between two undo boundaries as a single step to be undone.
  1902.  
  1903. If the value of the variable is t, undo information is not recorded.Vbuffer-undo-list
  1904. Vmark-active
  1905. Non-nil means the mark and region are currently active in this buffer.
  1906. Automatically local in all buffers.Vtransient-mark-mode
  1907. *Non-nil means deactivate the mark when the buffer contents change.Vinhibit-read-only
  1908. *Non-nil means disregard read-only status of buffers or characters.
  1909. If the value is t, disregard `buffer-read-only' and all `read-only'
  1910. text properties.  If the value is a list, disregard `buffer-read-only'
  1911. and disregard a `read-only' text property if the property value
  1912. is a member of the list.Flock-buffer
  1913. Lock FILE, if current buffer is modified.
  1914. FILE defaults to current buffer's visited file,
  1915. or else nothing is done if current buffer isn't visiting a file.
  1916.  
  1917. arguments: (&optional fn)Funlock-buffer
  1918. Unlock the file visited in the current buffer,
  1919. if it should normally be locked.
  1920.  
  1921. arguments: ()Ffile-locked-p
  1922. Return nil if the FILENAME is not locked,
  1923. t if it is locked by you, else a string of the name of the locker.
  1924.  
  1925. arguments: (&optional fn)Fmarker-buffer
  1926. Return the buffer that MARKER points into, or nil if none.
  1927. Returns nil if MARKER points into a dead buffer.
  1928.  
  1929. arguments: (marker)Fmarker-position
  1930. Return the position MARKER points at, as a character number.
  1931.  
  1932. arguments: (marker)Fset-marker
  1933. Position MARKER before character number NUMBER in BUFFER.
  1934. BUFFER defaults to the current buffer.
  1935. If NUMBER is nil, makes marker point nowhere.
  1936. Then it no longer slows down editing in any buffer.
  1937. Returns MARKER.
  1938.  
  1939. arguments: (marker pos &optional buffer)Fcopy-marker
  1940. Return a new marker pointing at the same place as MARKER.
  1941. If argument is a number, makes a new marker pointing
  1942. at that position in the current buffer.
  1943.  
  1944. arguments: (marker)Ftext-properties-at
  1945. Return the list of properties held by the character at POSITION
  1946. in optional argument OBJECT, a string or buffer.  If nil, OBJECT
  1947. defaults to the current buffer.
  1948. If POSITION is at the end of OBJECT, the value is nil.
  1949.  
  1950. arguments: (pos &optional object)Fget-text-property
  1951. Return the value of position POS's property PROP, in OBJECT.
  1952. OBJECT is optional and defaults to the current buffer.
  1953. If POSITION is at the end of OBJECT, the value is nil.
  1954.  
  1955. arguments: (pos prop &optional object)Fnext-property-change
  1956. Return the position of next property change.
  1957. Scans characters forward from POS in OBJECT till it finds
  1958. a change in some text property, then returns the position of the change.
  1959. The optional second argument OBJECT is the string or buffer to scan.
  1960. Return nil if the property is constant all the way to the end of OBJECT.
  1961. If the value is non-nil, it is a position greater than POS, never equal.
  1962.  
  1963. If the optional third argument LIMIT is non-nil, don't search
  1964. past position LIMIT; return LIMIT if nothing is found before LIMIT.
  1965.  
  1966. arguments: (pos &optional object limit)Fnext-single-property-change
  1967. Return the position of next property change for a specific property.
  1968. Scans characters forward from POS till it finds
  1969. a change in the PROP property, then returns the position of the change.
  1970. The optional third argument OBJECT is the string or buffer to scan.
  1971. The property values are compared with `eq'.
  1972. Return nil if the property is constant all the way to the end of OBJECT.
  1973. If the value is non-nil, it is a position greater than POS, never equal.
  1974.  
  1975. If the optional fourth argument LIMIT is non-nil, don't search
  1976. past position LIMIT; fail if nothing is found before LIMIT.
  1977.  
  1978. arguments: (pos prop &optional object limit)Fprevious-property-change
  1979. Return the position of previous property change.
  1980. Scans characters backwards from POS in OBJECT till it finds
  1981. a change in some text property, then returns the position of the change.
  1982. The optional second argument OBJECT is the string or buffer to scan.
  1983. Return nil if the property is constant all the way to the start of OBJECT.
  1984. If the value is non-nil, it is a position less than POS, never equal.
  1985.  
  1986. If the optional third argument LIMIT is non-nil, don't search
  1987. back past position LIMIT; fail if nothing is found before LIMIT.
  1988.  
  1989. arguments: (pos &optional object limit)Fprevious-single-property-change
  1990. Return the position of previous property change for a specific property.
  1991. Scans characters backward from POS till it finds
  1992. a change in the PROP property, then returns the position of the change.
  1993. The optional third argument OBJECT is the string or buffer to scan.
  1994. The property values are compared with `eq'.
  1995. Return nil if the property is constant all the way to the start of OBJECT.
  1996. If the value is non-nil, it is a position less than POS, never equal.
  1997.  
  1998. If the optional fourth argument LIMIT is non-nil, don't search
  1999. back past position LIMIT; fail if nothing is found before LIMIT.
  2000.  
  2001. arguments: (pos prop &optional object limit)Fadd-text-properties
  2002. Add properties to the text from START to END.
  2003. The third argument PROPS is a property list
  2004. specifying the property values to add.
  2005. The optional fourth argument, OBJECT,
  2006. is the string or buffer containing the text.
  2007. Return t if any property value actually changed, nil otherwise.
  2008.  
  2009. arguments: (start end properties &optional object)Fput-text-property
  2010. Set one property of the text from START to END.
  2011. The third and fourth arguments PROP and VALUE
  2012. specify the property to add.
  2013. The optional fifth argument, OBJECT,
  2014. is the string or buffer containing the text.
  2015.  
  2016. arguments: (start end prop value &optional object)Fset-text-properties
  2017. Completely replace properties of text from START to END.
  2018. The third argument PROPS is the new property list.
  2019. The optional fourth argument, OBJECT,
  2020. is the string or buffer containing the text.
  2021.  
  2022. arguments: (start end props &optional object)Fremove-text-properties
  2023. Remove some properties from text from START to END.
  2024. The third argument PROPS is a property list
  2025. whose property names specify the properties to remove.
  2026. (The values stored in PROPS are ignored.)
  2027. The optional fourth argument, OBJECT,
  2028. is the string or buffer containing the text.
  2029. Return t if any property was actually removed, nil otherwise.
  2030.  
  2031. arguments: (start end props &optional object)Ftext-property-any
  2032. Check text from START to END to see if PROP is ever `eq' to VALUE.
  2033. If so, return the position of the first character whose PROP is `eq'
  2034. to VALUE.  Otherwise return nil.
  2035. The optional fifth argument, OBJECT, is the string or buffer
  2036. containing the text.
  2037.  
  2038. arguments: (start end prop value &optional object)Ftext-property-not-all
  2039. Check text from START to END to see if PROP is ever not `eq' to VALUE.
  2040. If so, return the position of the first character whose PROP is not
  2041. `eq' to VALUE.  Otherwise, return nil.
  2042. The optional fifth argument, OBJECT, is the string or buffer
  2043. containing the text.
  2044.  
  2045. arguments: (start end prop value &optional object)Ferase-text-properties
  2046. Remove all properties from the text from START to END.
  2047. The optional third argument, OBJECT,
  2048. is the string or buffer containing the text.
  2049.  
  2050. arguments: (start end &optional object)Vinterval-balance-threshold
  2051. Threshold for rebalancing interval trees, expressed as the
  2052. percentage by which the left interval tree should not differ from the right.Vinhibit-point-motion-hooks
  2053. If nonnil, don't call the text property values of
  2054. `point-left' and `point-entered'.Fread-from-minibuffer
  2055. Read a string from the minibuffer, prompting with string PROMPT.
  2056. If optional second arg INITIAL-CONTENTS is non-nil, it is a string
  2057.   to be inserted into the minibuffer before reading input.
  2058.   If INITIAL-CONTENTS is (STRING . POSITION), the initial input
  2059.   is STRING, but point is placed POSITION characters into the string.
  2060. Third arg KEYMAP is a keymap to use whilst reading;
  2061.   if omitted or nil, the default is `minibuffer-local-map'.
  2062. If fourth arg READ is non-nil, then interpret the result as a lisp object
  2063.   and return that object:
  2064.   in other words, do `(car (read-from-string INPUT-STRING))'
  2065. Fifth arg HIST, if non-nil, specifies a history list
  2066.   and optionally the initial position in the list.
  2067.   It can be a symbol, which is the history list variable to use,
  2068.   or it can be a cons cell (HISTVAR . HISTPOS).
  2069.   In that case, HISTVAR is the history list variable to use,
  2070.   and HISTPOS is the initial position (the position in the list
  2071.   which INITIAL-CONTENTS corresponds to).
  2072.   Positions are counted starting from 1 at the beginning of the list.
  2073.  
  2074. arguments: (prompt &optional initial-input keymap read hist)Fread-minibuffer
  2075. Return a Lisp object read using the minibuffer.
  2076. Prompt with PROMPT.  If non-nil, optional second arg INITIAL-CONTENTS
  2077. is a string to insert in the minibuffer before reading.
  2078.  
  2079. arguments: (prompt &optional initial-contents)Feval-minibuffer
  2080. Return value of Lisp expression read using the minibuffer.
  2081. Prompt with PROMPT.  If non-nil, optional second arg INITIAL-CONTENTS
  2082. is a string to insert in the minibuffer before reading.
  2083.  
  2084. arguments: (prompt &optional initial-contents)Fread-string
  2085. Read a string from the minibuffer, prompting with string PROMPT.
  2086. If non-nil second arg INITIAL-INPUT is a string to insert before reading.
  2087.  
  2088. arguments: (prompt &optional initial-input)Fread-no-blanks-input
  2089. Args PROMPT and INIT, strings.  Read a string from the terminal, not allowing blanks.
  2090. Prompt with PROMPT, and provide INIT as an initial value of the input string.
  2091.  
  2092. arguments: (prompt &optional init)Fread-command
  2093. One arg PROMPT, a string.  Read the name of a command and return as a symbol.
  2094. Prompts with PROMPT.
  2095.  
  2096. arguments: (prompt)Fread-function
  2097. One arg PROMPT, a string.  Read the name of a function and return as a symbol.
  2098. Prompts with PROMPT.
  2099.  
  2100. arguments: (prompt)Fread-variable
  2101. One arg PROMPT, a string.  Read the name of a user variable and return
  2102. it as a symbol.  Prompts with PROMPT.
  2103. A user variable is one whose documentation starts with a `*' character.
  2104.  
  2105. arguments: (prompt)Fread-buffer
  2106. One arg PROMPT, a string.  Read the name of a buffer and return as a string.
  2107. Prompts with PROMPT.
  2108. Optional second arg is value to return if user enters an empty line.
  2109. If optional third arg REQUIRE-MATCH is non-nil, only existing buffer names are allowed.
  2110.  
  2111. arguments: (prompt &optional def require-match)Ftry-completion
  2112. Return common substring of all completions of STRING in ALIST.
  2113. Each car of each element of ALIST is tested to see if it begins with STRING.
  2114. All that match are compared together; the longest initial sequence
  2115. common to all matches is returned as a string.
  2116. If there is no match at all, nil is returned.
  2117. For an exact match, t is returned.
  2118.  
  2119. ALIST can be an obarray instead of an alist.
  2120. Then the print names of all symbols in the obarray are the possible matches.
  2121.  
  2122. ALIST can also be a function to do the completion itself.
  2123. It receives three arguments: the values STRING, PREDICATE and nil.
  2124. Whatever it returns becomes the value of `try-completion'.
  2125.  
  2126. If optional third argument PREDICATE is non-nil,
  2127. it is used to test each possible match.
  2128. The match is a candidate only if PREDICATE returns non-nil.
  2129. The argument given to PREDICATE is the alist element or the symbol from the obarray.
  2130.  
  2131. arguments: (string alist &optional pred)Fall-completions
  2132. Search for partial matches to STRING in ALIST.
  2133. Each car of each element of ALIST is tested to see if it begins with STRING.
  2134. The value is a list of all the strings from ALIST that match.
  2135. ALIST can be an obarray instead of an alist.
  2136. Then the print names of all symbols in the obarray are the possible matches.
  2137.  
  2138. ALIST can also be a function to do the completion itself.
  2139. It receives three arguments: the values STRING, PREDICATE and t.
  2140. Whatever it returns becomes the value of `all-completion'.
  2141.  
  2142. If optional third argument PREDICATE is non-nil,
  2143. it is used to test each possible match.
  2144. The match is a candidate only if PREDICATE returns non-nil.
  2145. The argument given to PREDICATE is the alist element or the symbol from the obarray.
  2146.  
  2147. arguments: (string alist &optional pred)Fcompleting-read
  2148. Read a string in the minibuffer, with completion.
  2149. Args: PROMPT, TABLE, PREDICATE, REQUIRE-MATCH, INITIAL-INPUT, HIST.
  2150. PROMPT is a string to prompt with; normally it ends in a colon and a space.
  2151. TABLE is an alist whose elements' cars are strings, or an obarray.
  2152. PREDICATE limits completion to a subset of TABLE.
  2153. See `try-completion' for more details on completion, TABLE, and PREDICATE.
  2154. If REQUIRE-MATCH is non-nil, the user is not allowed to exit unless
  2155.  the input is (or completes to) an element of TABLE.
  2156.  If it is also not t, Return does not exit if it does non-null completion.
  2157. If INITIAL-INPUT is non-nil, insert it in the minibuffer initially.
  2158.   If it is (STRING . POSITION), the initial input
  2159.   is STRING, but point is placed POSITION characters into the string.
  2160. HIST, if non-nil, specifies a history list
  2161.   and optionally the initial position in the list.
  2162.   It can be a symbol, which is the history list variable to use,
  2163.   or it can be a cons cell (HISTVAR . HISTPOS).
  2164.   In that case, HISTVAR is the history list variable to use,
  2165.   and HISTPOS is the initial position (the position in the list
  2166.   which INITIAL-CONTENTS corresponds to).
  2167.   Positions are counted starting from 1 at the beginning of the list.
  2168. Completion ignores case if the ambient value of
  2169.   `completion-ignore-case' is non-nil.
  2170.  
  2171. arguments: (prompt table &optional pred require-match init hist)Fminibuffer-complete
  2172. Complete the minibuffer contents as far as possible.
  2173.  
  2174. arguments: ()Fminibuffer-complete-and-exit
  2175. Complete the minibuffer contents, and maybe exit.
  2176. Exit if the name is valid with no completion needed.
  2177. If name was completed to a valid match,
  2178. a repetition of this command will exit.
  2179.  
  2180. arguments: ()Fminibuffer-complete-word
  2181. Complete the minibuffer contents at most a single word.
  2182. After one word is completed as much as possible, a space or hyphen
  2183. is added, provided that matches some possible completion.
  2184.  
  2185. arguments: ()Fdisplay-completion-list
  2186. Display the list of completions, COMPLETIONS, using `standard-output'.
  2187. Each element may be just a symbol or string
  2188. or may be a list of two strings to be printed as if concatenated.
  2189.  
  2190. arguments: (completions)Fminibuffer-completion-help
  2191. Display a list of possible completions of the current minibuffer contents.
  2192.  
  2193. arguments: ()Fself-insert-and-exit
  2194. Terminate minibuffer input.
  2195.  
  2196. arguments: ()Fexit-minibuffer
  2197. Terminate this minibuffer argument.
  2198.  
  2199. arguments: ()Fminibuffer-depth
  2200. Return current depth of activations of minibuffer, a nonnegative integer.
  2201.  
  2202. arguments: ()Vminibuffer-setup-hook
  2203. Normal hook run just after entry to minibuffer.Vcompletion-auto-help
  2204. *Non-nil means automatically provide help for invalid completion input.Vcompletion-ignore-case
  2205. Non-nil means don't consider case significant in completion.Venable-recursive-minibuffers
  2206. *Non-nil means to allow minibuffer commands while in the minibuffer.
  2207. More precisely, this variable makes a difference when the minibuffer window
  2208. is the selected window.  If you are in some other window, minibuffer commands
  2209. are allowed even if a minibuffer is active.Vminibuffer-completion-table
  2210. Alist or obarray used for completion in the minibuffer.
  2211. This becomes the ALIST argument to `try-completion' and `all-completion'.
  2212.  
  2213. The value may alternatively be a function, which is given three arguments:
  2214.   STRING, the current buffer contents;
  2215.   PREDICATE, the predicate for filtering possible matches;
  2216.   CODE, which says what kind of things to do.
  2217. CODE can be nil, t or `lambda'.
  2218. nil means to return the best completion of STRING, or nil if there is none.
  2219. t means to return a list of all possible completions of STRING.
  2220. `lambda' means to return t if STRING is a valid completion as it stands.Vminibuffer-completion-predicate
  2221. Within call to `completing-read', this holds the PREDICATE argument.Vminibuffer-completion-confirm
  2222. Non-nil => demand confirmation of completion before exiting minibuffer.Vminibuffer-help-form
  2223. Value that `help-form' takes on inside the minibuffer.Vminibuffer-history-variable
  2224. History list symbol to add minibuffer values to.
  2225. Each minibuffer output is added with
  2226.   (set minibuffer-history-variable
  2227.        (cons STRING (symbol-value minibuffer-history-variable)))Vminibuffer-history-position
  2228. Current position of redoing in the history list.Ffind-file-name-handler
  2229. Return FILENAME's handler function, if its syntax is handled specially.
  2230. Otherwise, return nil.
  2231. A file name is handled if one of the regular expressions in
  2232. `file-name-handler-alist' matches it.
  2233.  
  2234. arguments: (filename)Ffile-name-directory
  2235. Return the directory component in file name NAME.
  2236. Return nil if NAME does not include a directory.
  2237. Otherwise return a directory spec.
  2238. Given a Unix syntax file name, returns a string ending in slash;
  2239. on VMS, perhaps instead a string ending in `:', `]' or `>'.
  2240.  
  2241. arguments: (file)Ffile-name-nondirectory
  2242. Return file name NAME sans its directory.
  2243. For example, in a Unix-syntax file name,
  2244. this is everything after the last slash,
  2245. or the entire name if it contains no slash.
  2246.  
  2247. arguments: (file)Funhandled-file-name-directory
  2248. Return a directly usable directory name somehow associated with FILENAME.
  2249. A `directly usable' directory name is one that may be used without the
  2250. intervention of any file handler.
  2251. If FILENAME is a directly usable file itself, return
  2252. (file-name-directory FILENAME).
  2253. The `call-process' and `start-process' functions use this function to
  2254. get a current directory to run processes in.
  2255.  
  2256. arguments: (filename)Ffile-name-as-directory
  2257. Return a string representing file FILENAME interpreted as a directory.
  2258. This operation exists because a directory is also a file, but its name as
  2259. a directory is different from its name as a file.
  2260. The result can be used as the value of `default-directory'
  2261. or passed as second argument to `expand-file-name'.
  2262. For a Unix-syntax file name, just appends a slash.
  2263. On VMS, converts "[X]FOO.DIR" to "[X.FOO]", etc.
  2264.  
  2265. arguments: (file)Fdirectory-file-name
  2266. Returns the file name of the directory named DIR.
  2267. This is the name of the file that holds the data for the directory DIR.
  2268. This operation exists because a directory is also a file, but its name as
  2269. a directory is different from its name as a file.
  2270. In Unix-syntax, this function just removes the final slash.
  2271. On VMS, given a VMS-syntax directory name such as "[X.Y]",
  2272. it returns a file name such as "[X]Y.DIR.1".
  2273.  
  2274. arguments: (directory)Fmake-temp-name
  2275. Generate temporary file name (string) starting with PREFIX (a string).
  2276. The Emacs process number forms part of the result,
  2277. so there is no danger of generating a name being used by another process.
  2278.  
  2279. arguments: (prefix)Fexpand-file-name
  2280. Convert FILENAME to absolute, and canonicalize it.
  2281. Second arg DEFAULT is directory to start with if FILENAME is relative
  2282.  (does not start with slash); if DEFAULT is nil or missing,
  2283. the current buffer's value of default-directory is used.
  2284. Path components that are `.' are removed, and 
  2285. path components followed by `..' are removed, along with the `..' itself;
  2286. note that these simplifications are done without checking the resulting
  2287. paths in the file system.
  2288. An initial `~/' expands to your home directory.
  2289. An initial `~USER/' expands to USER's home directory.
  2290. See also the function `substitute-in-file-name'.
  2291.  
  2292. arguments: (name &optional default)Fsubstitute-in-file-name
  2293. Substitute environment variables referred to in FILENAME.
  2294. `$FOO' where FOO is an environment variable name means to substitute
  2295. the value of that variable.  The variable name should be terminated
  2296. with a character not a letter, digit or underscore; otherwise, enclose
  2297. the entire variable name in braces.
  2298. If `/~' appears, all of FILENAME through that `/' is discarded.
  2299.  
  2300. On VMS, `$' substitution is not done; this function does little and only
  2301. duplicates what `expand-file-name' does.
  2302.  
  2303. arguments: (string)Fcopy-file
  2304. Copy FILE to NEWNAME.  Both args must be strings.
  2305. Signals a `file-already-exists' error if file NEWNAME already exists,
  2306. unless a third argument OK-IF-ALREADY-EXISTS is supplied and non-nil.
  2307. A number as third arg means request confirmation if NEWNAME already exists.
  2308. This is what happens in interactive use with M-x.
  2309. Fourth arg KEEP-TIME non-nil means give the new file the same
  2310. last-modified time as the old one.  (This works on only some systems.)
  2311. A prefix arg makes KEEP-TIME non-nil.
  2312.  
  2313. arguments: (filename newname &optional ok-if-already-exists keep-date)Fmake-directory-internal
  2314. Create a directory.  One argument, a file name string.
  2315.  
  2316. arguments: (dirname)Fdelete-directory
  2317. Delete a directory.  One argument, a file name string.
  2318.  
  2319. arguments: (dirname)Fdelete-file
  2320. Delete specified file.  One argument, a file name string.
  2321. If file has multiple names, it continues to exist with the other names.
  2322.  
  2323. arguments: (filename)Frename-file
  2324. Rename FILE as NEWNAME.  Both args strings.
  2325. If file has names other than FILE, it continues to have those names.
  2326. Signals a `file-already-exists' error if a file NEWNAME already exists
  2327. unless optional third argument OK-IF-ALREADY-EXISTS is non-nil.
  2328. A number as third arg means request confirmation if NEWNAME already exists.
  2329. This is what happens in interactive use with M-x.
  2330.  
  2331. arguments: (filename newname &optional ok-if-already-exists)Fadd-name-to-file
  2332. Give FILE additional name NEWNAME.  Both args strings.
  2333. Signals a `file-already-exists' error if a file NEWNAME already exists
  2334. unless optional third argument OK-IF-ALREADY-EXISTS is non-nil.
  2335. A number as third arg means request confirmation if NEWNAME already exists.
  2336. This is what happens in interactive use with M-x.
  2337.  
  2338. arguments: (filename newname &optional ok-if-already-exists)Fmake-symbolic-link
  2339. Make a symbolic link to FILENAME, named LINKNAME.  Both args strings.
  2340. Signals a `file-already-exists' error if a file NEWNAME already exists
  2341. unless optional third argument OK-IF-ALREADY-EXISTS is non-nil.
  2342. A number as third arg means request confirmation if NEWNAME already exists.
  2343. This happens for interactive use with M-x.
  2344.  
  2345. arguments: (filename linkname &optional ok-if-already-exists)Fdefine-logical-name
  2346. Define the job-wide logical name NAME to have the value STRING.
  2347. If STRING is nil or a null string, the logical name NAME is deleted.
  2348.  
  2349. arguments: (varname string)Fsysnetunam
  2350. Open a network connection to PATH using LOGIN as the login string.
  2351.  
  2352. arguments: (path login)Ffile-name-absolute-p
  2353. Return t if file FILENAME specifies an absolute path name.
  2354. On Unix, this is a name starting with a `/' or a `~'.
  2355.  
  2356. arguments: (filename)Ffile-exists-p
  2357. Return t if file FILENAME exists.  (This does not mean you can read it.)
  2358. See also `file-readable-p' and `file-attributes'.
  2359.  
  2360. arguments: (filename)Ffile-executable-p
  2361. Return t if FILENAME can be executed by you.
  2362. For a directory, this means you can access files in that directory.
  2363.  
  2364. arguments: (filename)Ffile-readable-p
  2365. Return t if file FILENAME exists and you can read it.
  2366. See also `file-exists-p' and `file-attributes'.
  2367.  
  2368. arguments: (filename)Ffile-symlink-p
  2369. If file FILENAME is the name of a symbolic link
  2370. returns the name of the file to which it is linked.
  2371. Otherwise returns NIL.
  2372.  
  2373. arguments: (filename)Ffile-writable-p
  2374. Return t if file FILENAME can be written or created by you.
  2375.  
  2376. arguments: (filename)Ffile-directory-p
  2377. Return t if file FILENAME is the name of a directory as a file.
  2378. A directory name spec may be given instead; then the value is t
  2379. if the directory so specified exists and really is a directory.
  2380.  
  2381. arguments: (filename)Ffile-accessible-directory-p
  2382. Return t if file FILENAME is the name of a directory as a file,
  2383. and files in that directory can be opened by you.  In order to use a
  2384. directory as a buffer's current directory, this predicate must return true.
  2385. A directory name spec may be given instead; then the value is t
  2386. if the directory so specified exists and really is a readable and
  2387. searchable directory.
  2388.  
  2389. arguments: (filename)Ffile-modes
  2390. Return mode bits of FILE, as an integer.
  2391.  
  2392. arguments: (filename)Fset-file-modes
  2393. Set mode bits of FILE to MODE (an integer).
  2394. Only the 12 low bits of MODE are used.
  2395.  
  2396. arguments: (filename mode)Fset-default-file-modes
  2397. Set the file permission bits for newly created files.
  2398. The argument MODE should be an integer; only the low 9 bits are used.
  2399. This setting is inherited by subprocesses.
  2400.  
  2401. arguments: (mode)Fdefault-file-modes
  2402. Return the default file protection for created files.
  2403. The value is an integer.
  2404.  
  2405. arguments: ()Funix-sync
  2406. Tell Unix to finish all pending disk updates.
  2407.  
  2408. arguments: ()Ffile-newer-than-file-p
  2409. Return t if file FILE1 is newer than file FILE2.
  2410. If FILE1 does not exist, the answer is nil;
  2411. otherwise, if FILE2 does not exist, the answer is t.
  2412.  
  2413. arguments: (file1 file2)Finsert-file-contents
  2414. Insert contents of file FILENAME after point.
  2415. Returns list of absolute file name and length of data inserted.
  2416. If second argument VISIT is non-nil, the buffer's visited filename
  2417. and last save file modtime are set, and it is marked unmodified.
  2418. If visiting and the file does not exist, visiting is completed
  2419. before the error is signaled.
  2420.  
  2421. The optional third and fourth arguments BEG and END
  2422. specify what portion of the file to insert.
  2423. If VISIT is non-nil, BEG and END must be nil.
  2424.  
  2425. arguments: (filename &optional visit beg end)Fwrite-region
  2426. Write current region into specified file.
  2427. When called from a program, takes three arguments:
  2428. START, END and FILENAME.  START and END are buffer positions.
  2429. Optional fourth argument APPEND if non-nil means
  2430.   append to existing file contents (if any).
  2431. Optional fifth argument VISIT if t means
  2432.   set the last-save-file-modtime of buffer to this file's modtime
  2433.   and mark buffer not modified.
  2434. If VISIT is a string, it is a second file name;
  2435.   the output goes to FILENAME, but the buffer is marked as visiting VISIT.
  2436.   VISIT is also the file name to lock and unlock for clash detection.
  2437. If VISIT is neither t nor nil nor a string,
  2438.   that means do not print the "Wrote file" message.
  2439. Kludgy feature: if START is a string, then that string is written
  2440. to the file, instead of any buffer contents, and END is ignored.
  2441.  
  2442. arguments: (start end filename &optional append visit)Fcar-less-than-car
  2443. Return t if (car A) is numerically less than (car B).
  2444.  
  2445. arguments: (a b)Fverify-visited-file-modtime
  2446. Return t if last mod time of BUF's visited file matches what BUF records.
  2447. This means that the file has not been changed since it was visited or saved.
  2448.  
  2449. arguments: (buf)Fclear-visited-file-modtime
  2450. Clear out records of last mod time of visited file.
  2451. Next attempt to save will certainly not complain of a discrepancy.
  2452.  
  2453. arguments: ()Fvisited-file-modtime
  2454. Return the current buffer's recorded visited file modification time.
  2455. The value is a list of the form (HIGH . LOW), like the time values
  2456. that `file-attributes' returns.
  2457.  
  2458. arguments: ()Fset-visited-file-modtime
  2459. Update buffer's recorded modification time from the visited file's time.
  2460. Useful if the buffer was not read from the file normally
  2461. or if the file itself has been changed for some known benign reason.
  2462. An argument specifies the modification time value to use
  2463. (instead of that of the visited file), in the form of a list
  2464. (HIGH . LOW) or (HIGH LOW).
  2465.  
  2466. arguments: (&optional time-list)Fdo-auto-save
  2467. Auto-save all buffers that need it.
  2468. This is all buffers that have auto-saving enabled
  2469. and are changed since last auto-saved.
  2470. Auto-saving writes the buffer into a file
  2471. so that your editing is not lost if the system crashes.
  2472. This file is not the file you visited; that changes only when you save.
  2473.  
  2474. Non-nil first argument means do not print any message if successful.
  2475. Non-nil second argument means save only current buffer.
  2476.  
  2477. arguments: (&optional no-message current-only)Fset-buffer-auto-saved
  2478. Mark current buffer as auto-saved with its current text.
  2479. No auto-save file will be written until the buffer changes again.
  2480.  
  2481. arguments: ()Frecent-auto-save-p
  2482. Return t if buffer has been auto-saved since last read in or saved.
  2483.  
  2484. arguments: ()Fread-file-name-internal
  2485. Internal subroutine for read-file-name.  Do not call this.
  2486.  
  2487. arguments: (string dir action)Fread-file-name
  2488. Read file name, prompting with PROMPT and completing in directory DIR.
  2489. Value is not expanded---you must call `expand-file-name' yourself.
  2490. Default name to DEFAULT if user enters a null string.
  2491.  (If DEFAULT is omitted, the visited file name is used.)
  2492. Fourth arg MUSTMATCH non-nil means require existing file's name.
  2493.  Non-nil and non-t means also require confirmation after completion.
  2494. Fifth arg INITIAL specifies text to start with.
  2495. DIR defaults to current buffer's directory default.
  2496.  
  2497. arguments: (prompt &optional dir default mustmatch initial)Fread-file-name
  2498. Read file name, prompting with PROMPT and completing in directory DIR.
  2499. Value is not expanded---you must call `expand-file-name' yourself.
  2500. Default name to DEFAULT if user enters a null string.
  2501.  (If DEFAULT is omitted, the visited file name is used.)
  2502. Fourth arg MUSTMATCH non-nil means require existing file's name.
  2503.  Non-nil and non-t means also require confirmation after completion.
  2504. Fifth arg INITIAL specifies text to start with.
  2505. DIR defaults to current buffer's directory default.
  2506.  
  2507. arguments: (prompt &optional dir default mustmatch initial)Vinsert-default-directory
  2508. *Non-nil means when reading a filename start with default dir in minibuffer.Vvms-stmlf-recfm
  2509. *Non-nil means write new files with record format `stmlf'.
  2510. nil means use format `var'.  This variable is meaningful only on VMS.Vfile-name-handler-alist
  2511. *Alist of elements (REGEXP . HANDLER) for file names handled specially.
  2512. If a file name matches REGEXP, then all I/O on that file is done by calling
  2513. HANDLER.
  2514.  
  2515. The first argument given to HANDLER is the name of the I/O primitive
  2516. to be handled; the remaining arguments are the arguments that were
  2517. passed to that primitive.  For example, if you do
  2518.     (file-exists-p FILENAME)
  2519. and FILENAME is handled by HANDLER, then HANDLER is called like this:
  2520.     (funcall HANDLER 'file-exists-p FILENAME)
  2521. The function `find-file-name-handler' checks this list for a handler
  2522. for its argument.Vafter-insert-file-functions
  2523. A list of functions to be called at the end of `insert-file-contents'.
  2524. Each is passed one argument, the number of bytes inserted.  It should return
  2525. the new byte count, and leave point the same.  If `insert-file-contents' is
  2526. intercepted by a handler from `file-name-handler-alist', that handler is
  2527. responsible for calling the after-insert-file-functions if appropriate.Vwrite-region-annotate-functions
  2528. A list of functions to be called at the start of `write-region'.
  2529. Each is passed two arguments, START and END as for `write-region'.  It should
  2530. return a list of pairs (POSITION . STRING) of strings to be effectively
  2531. inserted at the specified positions of the file being written (1 means to
  2532. insert before the first byte written).  The POSITIONs must be sorted into
  2533. increasing order.  If there are several functions in the list, the several
  2534. lists are merged destructively.Fdirectory-files
  2535. Return a list of names of files in DIRECTORY.
  2536. There are three optional arguments:
  2537. If FULL is non-nil, absolute pathnames of the files are returned.
  2538. If MATCH is non-nil, only pathnames containing that regexp are returned.
  2539. If NOSORT is non-nil, the list is not sorted--its order is unpredictable.
  2540.  NOSORT is useful if you plan to sort the result yourself.
  2541.  
  2542. arguments: (dirname &optional full match nosort)Ffile-name-completion
  2543. Complete file name FILE in directory DIR.
  2544. Returns the longest string
  2545. common to all filenames in DIR that start with FILE.
  2546. If there is only one and FILE matches it exactly, returns t.
  2547. Returns nil if DIR contains no name starting with FILE.
  2548.  
  2549. arguments: (file dirname)Ffile-name-all-completions
  2550. Return a list of all completions of file name FILE in directory DIR.
  2551. These are all file names in directory DIR which begin with FILE.
  2552.  
  2553. arguments: (file dirname)Ffile-name-all-versions
  2554. Return a list of all versions of file name FILE in directory DIR.
  2555.  
  2556. arguments: (file dirname)Ffile-version-limit
  2557. Return the maximum number of versions allowed for FILE.
  2558. Returns nil if the file cannot be opened or if there is no version limit.
  2559.  
  2560. arguments: (filename)Ffile-attributes
  2561. Return a list of attributes of file FILENAME.
  2562. Value is nil if specified file cannot be opened.
  2563. Otherwise, list elements are:
  2564.  0. t for directory, string (name linked to) for symbolic link, or nil.
  2565.  1. Number of links to file.
  2566.  2. File uid.
  2567.  3. File gid.
  2568.  4. Last access time, as a list of two integers.
  2569.   First integer has high-order 16 bits of time, second has low 16 bits.
  2570.  5. Last modification time, likewise.
  2571.  6. Last status change time, likewise.
  2572.  7. Size in bytes (-1, if number is out of range).
  2573.  8. File modes, as a string of ten letters or dashes as in ls -l.
  2574.  9. t iff file's gid would change if file were deleted and recreated.
  2575. 10. inode number.
  2576. 11. Device number.
  2577.  
  2578. If file does not exist, returns nil.
  2579.  
  2580. arguments: (filename)Vcompletion-ignored-extensions
  2581. *Completion ignores filenames ending in any string in this list.
  2582. This variable does not affect lists of possible completions,
  2583. but does affect the commands that actually do completions.Fforward-char
  2584. Move point right ARG characters (left if ARG negative).
  2585. On reaching end of buffer, stop and signal error.
  2586.  
  2587. arguments: (&optional n)Fbackward-char
  2588. Move point left ARG characters (right if ARG negative).
  2589. On attempt to pass beginning or end of buffer, stop and signal error.
  2590.  
  2591. arguments: (&optional n)Fforward-line
  2592. Move ARG lines forward (backward if ARG is negative).
  2593. Precisely, if point is on line I, move to the start of line I + ARG.
  2594. If there isn't room, go as far as possible (no error).
  2595. Returns the count of lines left to move.  If moving forward,
  2596. that is ARG - number of lines moved; if backward, ARG + number moved.
  2597. With positive ARG, a non-empty line at the end counts as one line
  2598.   successfully moved (for the return value).
  2599.  
  2600. arguments: (&optional n)Fbeginning-of-line
  2601. Move point to beginning of current line.
  2602. With argument ARG not nil or 1, move forward ARG - 1 lines first.
  2603. If scan reaches end of buffer, stop there without error.
  2604.  
  2605. arguments: (&optional n)Fend-of-line
  2606. Move point to end of current line.
  2607. With argument ARG not nil or 1, move forward ARG - 1 lines first.
  2608. If scan reaches end of buffer, stop there without error.
  2609.  
  2610. arguments: (&optional n)Fdelete-char
  2611. Delete the following ARG characters (previous, with negative arg).
  2612. Optional second arg KILLFLAG non-nil means kill instead (save in kill ring).
  2613. Interactively, ARG is the prefix arg, and KILLFLAG is set if
  2614. ARG was explicitly specified.
  2615.  
  2616. arguments: (n &optional killflag)Fdelete-backward-char
  2617. Delete the previous ARG characters (following, with negative ARG).
  2618. Optional second arg KILLFLAG non-nil means kill instead (save in kill ring).
  2619. Interactively, ARG is the prefix arg, and KILLFLAG is set if
  2620. ARG was explicitly specified.
  2621.  
  2622. arguments: (n &optional killflag)Fself-insert-command
  2623. Insert the character you type.
  2624. Whichever character you type to run this command is inserted.
  2625.  
  2626. arguments: (arg)Fnewline
  2627. Insert a newline.  With arg, insert that many newlines.
  2628. In Auto Fill mode, if no numeric arg, break the preceding line if it's long.
  2629.  
  2630. arguments: (&optional arg1)Vblink-paren-function
  2631. Function called, if non-nil, whenever a close parenthesis is inserted.
  2632. More precisely, a char with closeparen syntax is self-inserted.Fcase-table-p
  2633. Return t iff ARG is a case table.
  2634. See `set-case-table' for more information on these data structures.
  2635.  
  2636. arguments: (table)Fcurrent-case-table
  2637. Return the case table of the current buffer.
  2638.  
  2639. arguments: ()Fstandard-case-table
  2640. Return the standard case table.
  2641. This is the one used for new buffers.
  2642.  
  2643. arguments: ()Fset-case-table
  2644. Select a new case table for the current buffer.
  2645. A case table is a list (DOWNCASE UPCASE CANONICALIZE EQUIVALENCES)
  2646.  where each element is either nil or a string of length 256.
  2647. DOWNCASE maps each character to its lower-case equivalent.
  2648. UPCASE maps each character to its upper-case equivalent;
  2649.  if lower and upper case characters are in 1-1 correspondence,
  2650.  you may use nil and the upcase table will be deduced from DOWNCASE.
  2651. CANONICALIZE maps each character to a canonical equivalent;
  2652.  any two characters that are related by case-conversion have the same
  2653.  canonical equivalent character.
  2654. EQUIVALENCES is a map that cyclicly permutes each equivalence class
  2655.  (of characters with the same canonical equivalent).
  2656. Both CANONICALIZE and EQUIVALENCES may be nil, in which case
  2657.  both are deduced from DOWNCASE and UPCASE.
  2658.  
  2659. arguments: (table)Fset-standard-case-table
  2660. Select a new standard case table for new buffers.
  2661. See `set-case-table' for more info on case tables.
  2662.  
  2663. arguments: (table)Vascii-downcase-table
  2664. String mapping ASCII characters to lowercase equivalents.Vascii-upcase-table
  2665. String mapping ASCII characters to uppercase equivalents.Fupcase
  2666. Convert argument to upper case and return that.
  2667. The argument may be a character or string.  The result has the same type.
  2668. The argument object is not altered.  See also `capitalize'.
  2669.  
  2670. arguments: (obj)Fdowncase
  2671. Convert argument to lower case and return that.
  2672. The argument may be a character or string.  The result has the same type.
  2673. The argument object is not altered.
  2674.  
  2675. arguments: (obj)Fcapitalize
  2676. Convert argument to capitalized form and return that.
  2677. This means that each word's first character is upper case
  2678. and the rest is lower case.
  2679. The argument may be a character or string.  The result has the same type.
  2680. The argument object is not altered.
  2681.  
  2682. arguments: (obj)Fupcase-region
  2683. Convert the region to upper case.  In programs, wants two arguments.
  2684. These arguments specify the starting and ending character numbers of
  2685. the region to operate on.  When used as a command, the text between
  2686. point and the mark is operated on.
  2687. See also `capitalize-region'.
  2688.  
  2689. arguments: (b e)Fdowncase-region
  2690. Convert the region to lower case.  In programs, wants two arguments.
  2691. These arguments specify the starting and ending character numbers of
  2692. the region to operate on.  When used as a command, the text between
  2693. point and the mark is operated on.
  2694.  
  2695. arguments: (b e)Fcapitalize-region
  2696. Convert the region to capitalized form.
  2697. Capitalized form means each word's first character is upper case
  2698. and the rest of it is lower case.
  2699. In programs, give two arguments, the starting and ending
  2700. character positions to operate on.
  2701.  
  2702. arguments: (b e)Fupcase-word
  2703. Convert following word (or ARG words) to upper case, moving over.
  2704. With negative argument, convert previous words but do not move.
  2705. See also `capitalize-word'.
  2706.  
  2707. arguments: (arg)Fdowncase-word
  2708. Convert following word (or ARG words) to lower case, moving over.
  2709. With negative argument, convert previous words but do not move.
  2710.  
  2711. arguments: (arg)Fcapitalize-word
  2712. Capitalize the following word (or ARG words), moving over.
  2713. This gives the word(s) a first character in upper case
  2714. and the rest lower case.
  2715. With negative argument, capitalize previous words but do not move.
  2716.  
  2717. arguments: (arg)Fcurrent-column
  2718. Return the horizontal position of point.  Beginning of line is column 0.
  2719. This is calculated by adding together the widths of all the displayed
  2720. representations of the character between the start of the previous line
  2721. and point.  (eg control characters will have a width of 2 or 4, tabs
  2722. will have a variable width)
  2723. Ignores finite width of frame, which means that this function may return
  2724. values greater than (frame-width).
  2725. Whether the line is visible (if `selective-display' is t) has no effect;
  2726. however, ^M is treated as end of line when `selective-display' is t.
  2727.  
  2728. arguments: ()Findent-to
  2729. Indent from point with tabs and spaces until COLUMN is reached.
  2730. Optional second argument MIN says always do at least MIN spaces
  2731. even if that goes past COLUMN; by default, MIN is zero.
  2732.  
  2733. arguments: (col &optional minimum)Fcurrent-indentation
  2734. Return the indentation of the current line.
  2735. This is the horizontal position of the character
  2736. following any initial whitespace.
  2737.  
  2738. arguments: ()Fmove-to-column
  2739. Move point to column COLUMN in the current line.
  2740. The column of a character is calculated by adding together the widths
  2741. as displayed of the previous characters in the line.
  2742. This function ignores line-continuation;
  2743. there is no upper limit on the column number a character can have
  2744. and horizontal scrolling has no effect.
  2745.  
  2746. If specified column is within a character, point goes after that character.
  2747. If it's past end of line, point goes to end of line.
  2748.  
  2749. A non-nil second (optional) argument FORCE means, if the line
  2750. is too short to reach column COLUMN then add spaces/tabs to get there,
  2751. and if COLUMN is in the middle of a tab character, change it to spaces.
  2752.  
  2753. arguments: (column &optional force)Fvertical-motion
  2754. Move to start of screen line LINES lines down.
  2755. If LINES is negative, this is moving up.
  2756. Sets point to position found; this may be start of line
  2757.  or just the start of a continuation line.
  2758. Returns number of lines moved; may be closer to zero than LINES
  2759.  if beginning or end of buffer was reached.
  2760.  
  2761. arguments: (lines)Vindent-tabs-mode
  2762. *Indentation can insert tabs if this is non-nil.
  2763. Setting this variable automatically makes it local to the current buffer.Flooking-at
  2764. Return t if text after point matches regular expression PAT.
  2765. This function modifies the match data that `match-beginning',
  2766. `match-end' and `match-data' access; save and restore the match
  2767. data if you want to preserve them.
  2768.  
  2769. arguments: (string)Fstring-match
  2770. Return index of start of first match for REGEXP in STRING, or nil.
  2771. If third arg START is non-nil, start search at that index in STRING.
  2772. For index of first char beyond the match, do (match-end 0).
  2773. `match-end' and `match-beginning' also give indices of substrings
  2774. matched by parenthesis constructs in the pattern.
  2775.  
  2776. arguments: (regexp string &optional start)Fskip-chars-forward
  2777. Move point forward, stopping before a char not in STRING, or at pos LIM.
  2778. STRING is like the inside of a `[...]' in a regular expression
  2779. except that `]' is never special and `\' quotes `^', `-' or `\'.
  2780. Thus, with arg "a-zA-Z", this skips letters stopping before first nonletter.
  2781. With arg "^a-zA-Z", skips nonletters stopping before first letter.
  2782. Returns the distance traveled, either zero or positive.
  2783.  
  2784. arguments: (string &optional lim)Fskip-chars-backward
  2785. Move point backward, stopping after a char not in STRING, or at pos LIM.
  2786. See `skip-chars-forward' for details.
  2787. Returns the distance traveled, either zero or negative.
  2788.  
  2789. arguments: (string &optional lim)Fskip-syntax-forward
  2790. Move point forward across chars in specified syntax classes.
  2791. SYNTAX is a string of syntax code characters.
  2792. Stop before a char whose syntax is not in SYNTAX, or at position LIM.
  2793. If SYNTAX starts with ^, skip characters whose syntax is NOT in SYNTAX.
  2794. This function returns the distance traveled, either zero or positive.
  2795.  
  2796. arguments: (syntax &optional lim)Fskip-syntax-backward
  2797. Move point backward across chars in specified syntax classes.
  2798. SYNTAX is a string of syntax code characters.
  2799. Stop on reaching a char whose syntax is not in SYNTAX, or at position LIM.
  2800. If SYNTAX starts with ^, skip characters whose syntax is NOT in SYNTAX.
  2801. This function returns the distance traveled, either zero or negative.
  2802.  
  2803. arguments: (syntax &optional lim)Fsearch-backward
  2804. Search backward from point for STRING.
  2805. Set point to the beginning of the occurrence found, and return point.
  2806. An optional second argument bounds the search; it is a buffer position.
  2807. The match found must not extend before that position.
  2808. Optional third argument, if t, means if fail just return nil (no error).
  2809.  If not nil and not t, position at limit of search and return nil.
  2810. Optional fourth argument is repeat count--search for successive occurrences.
  2811. See also the functions `match-beginning', `match-end' and `replace-match'.
  2812.  
  2813. arguments: (string &optional bound noerror count)Fsearch-forward
  2814. Search forward from point for STRING.
  2815. Set point to the end of the occurrence found, and return point.
  2816. An optional second argument bounds the search; it is a buffer position.
  2817. The match found must not extend after that position.  nil is equivalent
  2818.   to (point-max).
  2819. Optional third argument, if t, means if fail just return nil (no error).
  2820.   If not nil and not t, move to limit of search and return nil.
  2821. Optional fourth argument is repeat count--search for successive occurrences.
  2822. See also the functions `match-beginning', `match-end' and `replace-match'.
  2823.  
  2824. arguments: (string &optional bound noerror count)Fword-search-backward
  2825. Search backward from point for STRING, ignoring differences in punctuation.
  2826. Set point to the beginning of the occurrence found, and return point.
  2827. An optional second argument bounds the search; it is a buffer position.
  2828. The match found must not extend before that position.
  2829. Optional third argument, if t, means if fail just return nil (no error).
  2830.   If not nil and not t, move to limit of search and return nil.
  2831. Optional fourth argument is repeat count--search for successive occurrences.
  2832.  
  2833. arguments: (string &optional bound noerror count)Fword-search-forward
  2834. Search forward from point for STRING, ignoring differences in punctuation.
  2835. Set point to the end of the occurrence found, and return point.
  2836. An optional second argument bounds the search; it is a buffer position.
  2837. The match found must not extend after that position.
  2838. Optional third argument, if t, means if fail just return nil (no error).
  2839.   If not nil and not t, move to limit of search and return nil.
  2840. Optional fourth argument is repeat count--search for successive occurrences.
  2841.  
  2842. arguments: (string &optional bound noerror count)Fre-search-backward
  2843. Search backward from point for match for regular expression REGEXP.
  2844. Set point to the beginning of the match, and return point.
  2845. The match found is the one starting last in the buffer
  2846. and yet ending before the place the origin of the search.
  2847. An optional second argument bounds the search; it is a buffer position.
  2848. The match found must start at or after that position.
  2849. Optional third argument, if t, means if fail just return nil (no error).
  2850.   If not nil and not t, move to limit of search and return nil.
  2851. Optional fourth argument is repeat count--search for successive occurrences.
  2852. See also the functions `match-beginning', `match-end' and `replace-match'.
  2853.  
  2854. arguments: (string &optional bound noerror count)Fre-search-forward
  2855. Search forward from point for regular expression REGEXP.
  2856. Set point to the end of the occurrence found, and return point.
  2857. An optional second argument bounds the search; it is a buffer position.
  2858. The match found must not extend after that position.
  2859. Optional third argument, if t, means if fail just return nil (no error).
  2860.   If not nil and not t, move to limit of search and return nil.
  2861. Optional fourth argument is repeat count--search for successive occurrences.
  2862. See also the functions `match-beginning', `match-end' and `replace-match'.
  2863.  
  2864. arguments: (string &optional bound noerror count)Freplace-match
  2865. Replace text matched by last search with NEWTEXT.
  2866. If second arg FIXEDCASE is non-nil, do not alter case of replacement text.
  2867. Otherwise convert to all caps or cap initials, like replaced text.
  2868. If third arg LITERAL is non-nil, insert NEWTEXT literally.
  2869. Otherwise treat `\' as special:
  2870.   `\&' in NEWTEXT means substitute original matched text.
  2871.   `\N' means substitute what matched the Nth `\(...\)'.
  2872.        If Nth parens didn't match, substitute nothing.
  2873.   `\\' means insert one `\'.
  2874. FIXEDCASE and LITERAL are optional arguments.
  2875. Leaves point at end of replacement text.
  2876.  
  2877. arguments: (newtext &optional fixedcase literal)Fmatch-beginning
  2878. Return position of start of text matched by last search.
  2879. NUM specifies which parenthesized expression in the last regexp.
  2880.  Value is nil if NUMth pair didn't match, or there were less than NUM pairs.
  2881. Zero means the entire text matched by the whole regexp or whole string.
  2882.  
  2883. arguments: (num)Fmatch-end
  2884. Return position of end of text matched by last search.
  2885. ARG, a number, specifies which parenthesized expression in the last regexp.
  2886.  Value is nil if ARGth pair didn't match, or there were less than ARG pairs.
  2887. Zero means the entire text matched by the whole regexp or whole string.
  2888.  
  2889. arguments: (num)Fmatch-data
  2890. Return a list containing all info on what the last search matched.
  2891. Element 2N is `(match-beginning N)'; element 2N + 1 is `(match-end N)'.
  2892. All the elements are markers or nil (nil if the Nth pair didn't match)
  2893. if the last match was on a buffer; integers or nil if a string was matched.
  2894. Use `store-match-data' to reinstate the data in this list.
  2895.  
  2896. arguments: ()Fstore-match-data
  2897. Set internal data on last search match from elements of LIST.
  2898. LIST should have been created by calling `match-data' previously.
  2899.  
  2900. arguments: (list)Fregexp-quote
  2901. Return a regexp string which matches exactly STRING and nothing else.
  2902.  
  2903. arguments: (str)Fundo-boundary
  2904. Mark a boundary between units of undo.
  2905. An undo command will stop at this point,
  2906. but another undo command will undo to the previous boundary.
  2907.  
  2908. arguments: ()Fprimitive-undo
  2909. Undo N records from the front of the list LIST.
  2910. Return what remains of the list.
  2911.  
  2912. arguments: (n list)Fcons
  2913. Create a new cons, give it CAR and CDR as components, and return it.
  2914.  
  2915. arguments: (car cdr)Flist
  2916. Return a newly created list with specified arguments as elements.
  2917. Any number of arguments, even zero arguments, are allowed.Fmake-list
  2918. Return a newly created list of length LENGTH, with each element being INIT.
  2919.  
  2920. arguments: (length init)Fmake-vector
  2921. Return a newly created vector of length LENGTH, with each element being INIT.
  2922. See also the function `vector'.
  2923.  
  2924. arguments: (length init)Fvector
  2925. Return a newly created vector with specified arguments as elements.
  2926. Any number of arguments, even zero arguments, are allowed.Fmake-byte-code
  2927. Create a byte-code object with specified arguments as elements.
  2928. The arguments should be the arglist, bytecode-string, constant vector,
  2929. stack size, (optional) doc string, and (optional) interactive spec.
  2930. The first four arguments are required; at most six have any
  2931. significance.Fmake-symbol
  2932. Return a newly allocated uninterned symbol whose name is NAME.
  2933. Its value and function definition are void, and its property list is nil.
  2934.  
  2935. arguments: (str)Fmake-marker
  2936. Return a newly allocated marker which does not point at any place.
  2937.  
  2938. arguments: ()Fmake-string
  2939. Return a newly created string of length LENGTH, with each element being INIT.
  2940. Both LENGTH and INIT must be numbers.
  2941.  
  2942. arguments: (length init)Fpurecopy
  2943. Make a copy of OBJECT in pure storage.
  2944. Recursively copies contents of vectors and cons cells.
  2945. Does not copy symbols.
  2946.  
  2947. arguments: (obj)Fgarbage-collect
  2948. Reclaim storage for Lisp objects no longer needed.
  2949. Returns info on amount of space in use:
  2950.  ((USED-CONSES . FREE-CONSES) (USED-SYMS . FREE-SYMS)
  2951.   (USED-MARKERS . FREE-MARKERS) USED-STRING-CHARS USED-VECTOR-SLOTS
  2952.   (USED-FLOATS . FREE-FLOATS))
  2953. Garbage collection happens automatically if you cons more than
  2954. `gc-cons-threshold' bytes of Lisp data since previous garbage collection.
  2955.  
  2956. arguments: ()Fmemory-limit
  2957. Return the address of the last byte Emacs has allocated, divided by 1024.
  2958. This may be helpful in debugging Emacs's memory usage.
  2959. We divide the value by 1024 to make sure it fits in a Lisp integer.
  2960.  
  2961. arguments: ()Vgc-cons-threshold
  2962. *Number of bytes of consing between garbage collections.
  2963. Garbage collection can happen automatically once this many bytes have been
  2964. allocated since the last garbage collection.  All data types count.
  2965.  
  2966. Garbage collection happens automatically only when `eval' is called.
  2967.  
  2968. By binding this temporarily to a large number, you can effectively
  2969. prevent garbage collection during a part of the program.Vpure-bytes-used
  2970. Number of bytes of sharable Lisp data allocated so far.Vdata-bytes-used
  2971. Number of bytes of unshared memory allocated in this session.Vdata-bytes-free
  2972. Number of bytes of unshared memory remaining available in this session.Vpurify-flag
  2973. Non-nil means loading Lisp code in order to dump an executable.
  2974. This means that certain objects should be allocated in shared (pure) space.Vundo-limit
  2975. Keep no more undo information once it exceeds this size.
  2976. This limit is applied when garbage collection happens.
  2977. The size is counted as the number of bytes occupied,
  2978. which includes both saved text and other data.Vundo-strong-limit
  2979. Don't keep more than this much size of undo information.
  2980. A command which pushes past this size is itself forgotten.
  2981. This limit is applied when garbage collection happens.
  2982. The size is counted as the number of bytes occupied,
  2983. which includes both saved text and other data.Feq
  2984. T if the two args are the same Lisp object.
  2985.  
  2986. arguments: (obj1 obj2)Fnull
  2987. T if OBJECT is nil.
  2988.  
  2989. arguments: (obj)Fconsp
  2990. T if OBJECT is a cons cell.
  2991.  
  2992. arguments: (obj)Fatom
  2993. T if OBJECT is not a cons cell.  This includes nil.
  2994.  
  2995. arguments: (obj)Flistp
  2996. T if OBJECT is a list.  This includes nil.
  2997.  
  2998. arguments: (obj)Fnlistp
  2999. T if OBJECT is not a list.  Lists include nil.
  3000.  
  3001. arguments: (obj)Fsymbolp
  3002. T if OBJECT is a symbol.
  3003.  
  3004. arguments: (obj)Fvectorp
  3005. T if OBJECT is a vector.
  3006.  
  3007. arguments: (obj)Fstringp
  3008. T if OBJECT is a string.
  3009.  
  3010. arguments: (obj)Farrayp
  3011. T if OBJECT is an array (string or vector).
  3012.  
  3013. arguments: (obj)Fsequencep
  3014. T if OBJECT is a sequence (list or array).
  3015.  
  3016. arguments: (obj)Fbufferp
  3017. T if OBJECT is an editor buffer.
  3018.  
  3019. arguments: (obj)Fmarkerp
  3020. T if OBJECT is a marker (editor pointer).
  3021.  
  3022. arguments: (obj)Fsubrp
  3023. T if OBJECT is a built-in function.
  3024.  
  3025. arguments: (obj)Fbyte-code-function-p
  3026. T if OBJECT is a byte-compiled function object.
  3027.  
  3028. arguments: (obj)Fchar-or-string-p
  3029. T if OBJECT is a character (a number) or a string.
  3030.  
  3031. arguments: (obj)Fintegerp
  3032. T if OBJECT is a number.
  3033.  
  3034. arguments: (obj)Finteger-or-marker-p
  3035. T if OBJECT is an integer or a marker (editor pointer).
  3036.  
  3037. arguments: (obj)Fnatnump
  3038. T if OBJECT is a nonnegative number.
  3039.  
  3040. arguments: (obj)Fnumberp
  3041. T if OBJECT is a number (floating point or integer).
  3042.  
  3043. arguments: (obj)Fnumber-or-marker-p
  3044. T if OBJECT is a number or a marker.
  3045.  
  3046. arguments: (obj)Ffloatp
  3047. T if OBJECT is a floating point number.
  3048.  
  3049. arguments: (obj)Fcar
  3050. Return the car of CONSCELL.  If arg is nil, return nil.
  3051. Error if arg is not nil and not a cons cell.  See also `car-safe'.
  3052.  
  3053. arguments: (list)Fcar-safe
  3054. Return the car of OBJECT if it is a cons cell, or else nil.
  3055.  
  3056. arguments: (object)Fcdr
  3057. Return the cdr of CONSCELL.  If arg is nil, return nil.
  3058. Error if arg is not nil and not a cons cell.  See also `cdr-safe'.
  3059.  
  3060. arguments: (list)Fcdr-safe
  3061. Return the cdr of OBJECT if it is a cons cell, or else  nil.
  3062.  
  3063. arguments: (object)Fsetcar
  3064. Set the car of CONSCELL to be NEWCAR.  Returns NEWCAR.
  3065.  
  3066. arguments: (cell newcar)Fsetcdr
  3067. Set the cdr of CONSCELL to be NEWCDR.  Returns NEWCDR.
  3068.  
  3069. arguments: (cell newcdr)Fboundp
  3070. T if SYMBOL's value is not void.
  3071.  
  3072. arguments: (sym)Ffboundp
  3073. T if SYMBOL's function definition is not void.
  3074.  
  3075. arguments: (sym)Fmakunbound
  3076. Make SYMBOL's value be void.
  3077.  
  3078. arguments: (sym)Ffmakunbound
  3079. Make SYMBOL's function definition be void.
  3080.  
  3081. arguments: (sym)Fsymbol-function
  3082. Return SYMBOL's function definition.  Error if that is void.
  3083.  
  3084. arguments: (symbol)Fsymbol-plist
  3085. Return SYMBOL's property list.
  3086.  
  3087. arguments: (sym)Fsymbol-name
  3088. Return SYMBOL's name, a string.
  3089.  
  3090. arguments: (sym)Ffset
  3091. Set SYMBOL's function definition to NEWVAL, and return NEWVAL.
  3092.  
  3093. arguments: (sym newdef)Fdefalias
  3094. Set SYMBOL's function definition to NEWVAL, and return NEWVAL.
  3095. Associates the function with the current load file, if any.
  3096.  
  3097. arguments: (sym newdef)Fdefine-function
  3098. Set SYMBOL's function definition to NEWVAL, and return NEWVAL.
  3099. Associates the function with the current load file, if any.
  3100.  
  3101. arguments: (sym newdef)Fsetplist
  3102. Set SYMBOL's property list to NEWVAL, and return NEWVAL.
  3103.  
  3104. arguments: (sym newplist)Fsymbol-value
  3105. Return SYMBOL's value.  Error if that is void.
  3106.  
  3107. arguments: (sym)Fset
  3108. Set SYMBOL's value to NEWVAL, and return NEWVAL.
  3109.  
  3110. arguments: (sym newval)Fdefault-boundp
  3111. Return T if SYMBOL has a non-void default value.
  3112. This is the value that is seen in buffers that do not have their own values
  3113. for this variable.
  3114.  
  3115. arguments: (sym)Fdefault-value
  3116. Return SYMBOL's default value.
  3117. This is the value that is seen in buffers that do not have their own values
  3118. for this variable.  The default value is meaningful for variables with
  3119. local bindings in certain buffers.
  3120.  
  3121. arguments: (sym)Fset-default
  3122. Set SYMBOL's default value to VAL.  SYMBOL and VAL are evaluated.
  3123. The default value is seen in buffers that do not have their own values
  3124. for this variable.
  3125.  
  3126. arguments: (sym value)Fsetq-default
  3127. (setq-default SYM VAL SYM VAL ...): set each SYM's default value to its VAL.
  3128. VAL is evaluated; SYM is not.  The default value is seen in buffers that do
  3129. not have their own values for this variable.Fmake-variable-buffer-local
  3130. Make VARIABLE have a separate value for each buffer.
  3131. At any time, the value for the current buffer is in effect.
  3132. There is also a default value which is seen in any buffer which has not yet
  3133. set its own value.
  3134. Using `set' or `setq' to set the variable causes it to have a separate value
  3135. for the current buffer if it was previously using the default value.
  3136. The function `default-value' gets the default value and `set-default' sets it.
  3137.  
  3138. arguments: (sym)Fmake-local-variable
  3139. Make VARIABLE have a separate value in the current buffer.
  3140. Other buffers will continue to share a common default value.
  3141. See also `make-variable-buffer-local'.
  3142.  
  3143. If the variable is already arranged to become local when set,
  3144. this function causes a local value to exist for this buffer,
  3145. just as if the variable were set.
  3146.  
  3147. arguments: (sym)Fkill-local-variable
  3148. Make VARIABLE no longer have a separate value in the current buffer.
  3149. From now on the default value will apply in this buffer.
  3150.  
  3151. arguments: (sym)Findirect-function
  3152. Return the function at the end of OBJECT's function chain.
  3153. If OBJECT is a symbol, follow all function indirections and return the final
  3154. function binding.
  3155. If OBJECT is not a symbol, just return it.
  3156. Signal a void-function error if the final symbol is unbound.
  3157. Signal a cyclic-function-indirection error if there is a loop in the
  3158. function chain of symbols.
  3159.  
  3160. arguments: (object)Faref
  3161. Return the element of ARRAY at index INDEX.
  3162. ARRAY may be a vector or a string, or a byte-code object.  INDEX starts at 0.
  3163.  
  3164. arguments: (array idx)Faset
  3165. Store into the element of ARRAY at index INDEX the value NEWVAL.
  3166. ARRAY may be a vector or a string.  INDEX starts at 0.
  3167.  
  3168. arguments: (array idx newelt)F=
  3169. T if two args, both numbers or markers, are equal.
  3170.  
  3171. arguments: (num1 num2)F<
  3172. T if first arg is less than second arg.  Both must be numbers or markers.
  3173.  
  3174. arguments: (num1 num2)F>
  3175. T if first arg is greater than second arg.  Both must be numbers or markers.
  3176.  
  3177. arguments: (num1 num2)F<=
  3178. T if first arg is less than or equal to second arg.
  3179. Both must be numbers or markers.
  3180.  
  3181. arguments: (num1 num2)F>=
  3182. T if first arg is greater than or equal to second arg.
  3183. Both must be numbers or markers.
  3184.  
  3185. arguments: (num1 num2)F/=
  3186. T if first arg is not equal to second arg.  Both must be numbers or markers.
  3187.  
  3188. arguments: (num1 num2)Fzerop
  3189. T if NUMBER is zero.
  3190.  
  3191. arguments: (num)Fnumber-to-string
  3192. Convert NUM to a string by printing it in decimal.
  3193. Uses a minus sign if negative.
  3194. NUM may be an integer or a floating point number.
  3195.  
  3196. arguments: (num)Fstring-to-number
  3197. Convert STRING to a number by parsing it as a decimal number.
  3198. This parses both integers and floating point numbers.
  3199.  
  3200. arguments: (str)F+
  3201. Return sum of any number of arguments, which are numbers or markers.F-
  3202. Negate number or subtract numbers or markers.
  3203. With one arg, negates it.  With more than one arg,
  3204. subtracts all but the first from the first.F*
  3205. Returns product of any number of arguments, which are numbers or markers.F/
  3206. Returns first argument divided by all the remaining arguments.
  3207. The arguments must be numbers or markers.F%
  3208. Returns remainder of first arg divided by second.
  3209. Both must be integers or markers.
  3210.  
  3211. arguments: (num1 num2)Fmod
  3212. Returns X modulo Y.
  3213. The result falls between zero (inclusive) and Y (exclusive).
  3214. Both X and Y must be numbers or markers.
  3215.  
  3216. arguments: (num1 num2)Fmax
  3217. Return largest of all the arguments (which must be numbers or markers).
  3218. The value is always a number; markers are converted to numbers.Fmin
  3219. Return smallest of all the arguments (which must be numbers or markers).
  3220. The value is always a number; markers are converted to numbers.Flogand
  3221. Return bitwise-and of all the arguments.
  3222. Arguments may be integers, or markers converted to integers.Flogior
  3223. Return bitwise-or of all the arguments.
  3224. Arguments may be integers, or markers converted to integers.Flogxor
  3225. Return bitwise-exclusive-or of all the arguments.
  3226. Arguments may be integers, or markers converted to integers.Fash
  3227. Return VALUE with its bits shifted left by COUNT.
  3228. If COUNT is negative, shifting is actually to the right.
  3229. In this case, the sign bit is duplicated.
  3230.  
  3231. arguments: (num1 num2)Flsh
  3232. Return VALUE with its bits shifted left by COUNT.
  3233. If COUNT is negative, shifting is actually to the right.
  3234. In this case,  zeros are shifted in on the left.
  3235.  
  3236. arguments: (num1 num2)F1+
  3237. Return NUMBER plus one.  NUMBER may be a number or a marker.
  3238. Markers are converted to integers.
  3239.  
  3240. arguments: (num)F1-
  3241. Return NUMBER minus one.  NUMBER may be a number or a marker.
  3242. Markers are converted to integers.
  3243.  
  3244. arguments: (num)Flognot
  3245. Return the bitwise complement of ARG.  ARG must be an integer.
  3246.  
  3247. arguments: (num)Fdocumentation
  3248. Return the documentation string of FUNCTION.
  3249. Unless a non-nil second argument is given, the
  3250. string is passed through `substitute-command-keys'.
  3251.  
  3252. arguments: (function &optional raw)Fdocumentation-property
  3253. Return the documentation string that is SYMBOL's PROP property.
  3254. This is like `get', but it can refer to strings stored in the
  3255. `etc/DOC' file; and if the value is a string, it is passed through
  3256. `substitute-command-keys'.  A non-nil third argument avoids this
  3257. translation.
  3258.  
  3259. arguments: (sym prop raw)FSnarf-documentation
  3260. Used during Emacs initialization, before dumping runnable Emacs,
  3261. to find pointers to doc strings stored in `etc/DOC...' and
  3262. record them in function definitions.
  3263. One arg, FILENAME, a string which does not include a directory.
  3264. The file is found in `../etc' now; found in the `data-directory'
  3265. when doc strings are referred to later in the dumped Emacs.
  3266.  
  3267. arguments: (filename)Fsubstitute-command-keys
  3268. Substitute key descriptions for command names in STRING.
  3269. Return a new string which is STRING with substrings of the form \=\[COMMAND]
  3270. replaced by either:  a keystroke sequence that will invoke COMMAND,
  3271. or "M-x COMMAND" if COMMAND is not on any keys.
  3272. Substrings of the form \=\{MAPVAR} are replaced by summaries
  3273. (made by describe-bindings) of the value of MAPVAR, taken as a keymap.
  3274. Substrings of the form \=\<MAPVAR> specify to use the value of MAPVAR
  3275. as the keymap for future \=\[COMMAND] substrings.
  3276. \=\= quotes the following character and is discarded;
  3277. thus, \=\=\=\= puts \=\= into the output, and \=\=\=\[ puts \=\[ into the output.
  3278.  
  3279. arguments: (str)Vinternal-doc-file-name
  3280. Name of file containing documentation strings of built-in symbols.Fchar-to-string
  3281. Convert arg CHAR to a one-character string containing that character.
  3282.  
  3283. arguments: (n)Fstring-to-char
  3284. Convert arg STRING to a character, the first character of that string.
  3285.  
  3286. arguments: (str)Fpoint
  3287. Return value of point, as an integer.
  3288. Beginning of buffer is position (point-min)
  3289.  
  3290. arguments: ()Fpoint-marker
  3291. Return value of point, as a marker object.
  3292.  
  3293. arguments: ()Fgoto-char
  3294. Set point to POSITION, a number or marker.
  3295. Beginning of buffer is position (point-min), end is (point-max).
  3296.  
  3297. arguments: (n)Fregion-beginning
  3298. Return position of beginning of region, as an integer.
  3299.  
  3300. arguments: ()Fregion-end
  3301. Return position of end of region, as an integer.
  3302.  
  3303. arguments: ()Fmark
  3304. Return this buffer's mark value as integer, or nil if no mark.
  3305. If you are using this in an editing command, you are most likely making
  3306. a mistake; see the documentation of `set-mark'.
  3307.  
  3308. arguments: ()Fmark-marker
  3309. Return this buffer's mark, as a marker object.
  3310. Watch out!  Moving this marker changes the mark position.
  3311. If you set the marker not to point anywhere, the buffer will have no mark.
  3312.  
  3313. arguments: ()Fset-mark
  3314. Set this buffer's mark to POS.  Don't use this function!
  3315. That is to say, don't use this function unless you want
  3316. the user to see that the mark has moved, and you want the previous
  3317. mark position to be lost.
  3318.  
  3319. Normally, when a new mark is set, the old one should go on the stack.
  3320. This is why most applications should use push-mark, not set-mark.
  3321.  
  3322. Novice programmers often try to use the mark for the wrong purposes.
  3323. The mark saves a location for the user's convenience.
  3324. Most editing commands should not alter the mark.
  3325. To remember a location for internal use in the Lisp program,
  3326. store it in a Lisp variable.  Example:
  3327.  
  3328.    (let ((beg (point))) (forward-line 1) (delete-region beg (point))).
  3329.  
  3330. arguments: (pos)Fsave-excursion
  3331. Save point, mark, and current buffer; execute BODY; restore those things.
  3332. Executes BODY just like `progn'.
  3333. The values of point, mark and the current buffer are restored
  3334. even in case of abnormal exit (throw or error).
  3335. The state of activation of the mark is also restored.Fbuffer-size
  3336. Return the number of characters in the current buffer.
  3337.  
  3338. arguments: ()Fpoint-min
  3339. Return the minimum permissible value of point in the current buffer.
  3340. This is 1, unless narrowing (a buffer restriction) is in effect.
  3341.  
  3342. arguments: ()Fpoint-min-marker
  3343. Return a marker to the minimum permissible value of point in this buffer.
  3344. This is the beginning, unless narrowing (a buffer restriction) is in effect.
  3345.  
  3346. arguments: ()Fpoint-max
  3347. Return the maximum permissible value of point in the current buffer.
  3348. This is (1+ (buffer-size)), unless narrowing (a buffer restriction)
  3349. is in effect, in which case it is less.
  3350.  
  3351. arguments: ()Fpoint-max-marker
  3352. Return a marker to the maximum permissible value of point in this buffer.
  3353. This is (1+ (buffer-size)), unless narrowing (a buffer restriction)
  3354. is in effect, in which case it is less.
  3355.  
  3356. arguments: ()Ffollowing-char
  3357. Return the character following point, as a number.
  3358. At the end of the buffer or accessible region, return 0.
  3359.  
  3360. arguments: ()Fpreceding-char
  3361. Return the character preceding point, as a number.
  3362. At the beginning of the buffer or accessible region, return 0.
  3363.  
  3364. arguments: ()Fbobp
  3365. Return T if point is at the beginning of the buffer.
  3366. If the buffer is narrowed, this means the beginning of the narrowed part.
  3367.  
  3368. arguments: ()Feobp
  3369. Return T if point is at the end of the buffer.
  3370. If the buffer is narrowed, this means the end of the narrowed part.
  3371.  
  3372. arguments: ()Fbolp
  3373. Return T if point is at the beginning of a line.
  3374.  
  3375. arguments: ()Feolp
  3376. Return T if point is at the end of a line.
  3377. `End of a line' includes point being at the end of the buffer.
  3378.  
  3379. arguments: ()Fchar-after
  3380. Return character in current buffer at position POS.
  3381. POS is an integer or a buffer pointer.
  3382. If POS is out of range, the value is nil.
  3383.  
  3384. arguments: (pos)Fuser-login-name
  3385. Return the name under which the user logged in, as a string.
  3386. This is based on the effective uid, not the real uid.
  3387. Also, if the environment variable USER or LOGNAME is set,
  3388. that determines the value of this function.
  3389.  
  3390. arguments: ()Fuser-real-login-name
  3391. Return the name of the user's real uid, as a string.
  3392. Differs from `user-login-name' when running under `su'.
  3393.  
  3394. arguments: ()Fuser-uid
  3395. Return the effective uid of Emacs, as an integer.
  3396.  
  3397. arguments: ()Fuser-real-uid
  3398. Return the real uid of Emacs, as an integer.
  3399.  
  3400. arguments: ()Fuser-full-name
  3401. Return the full name of the user logged in, as a string.
  3402.  
  3403. arguments: ()Fsystem-name
  3404. Return the name of the machine you are running on, as a string.
  3405.  
  3406. arguments: ()Fcurrent-time
  3407. Return the current time, as the number of seconds since 12:00 AM January 1970.
  3408. The time is returned as a list of three integers.  The first has the
  3409. most significant 16 bits of the seconds, while the second has the
  3410. least significant 16 bits.  The third integer gives the microsecond
  3411. count.
  3412.  
  3413. The microsecond count is zero on systems that do not provide
  3414. resolution finer than a second.
  3415.  
  3416. arguments: ()Fcurrent-time-string
  3417. Return the current time, as a human-readable string.
  3418. Programs can use this function to decode a time,
  3419. since the number of columns in each field is fixed.
  3420. The format is `Sun Sep 16 01:03:52 1973'.
  3421. If an argument is given, it specifies a time to format
  3422. instead of the current time.  The argument should have the form:
  3423.   (HIGH . LOW)
  3424. or the form:
  3425.   (HIGH LOW . IGNORED).
  3426. Thus, you can use times obtained from `current-time'
  3427. and from `file-attributes'.
  3428.  
  3429. arguments: (&optional specified-time)Fcurrent-time-zone
  3430. Return the offset and name for the local time zone.
  3431. This returns a list of the form (OFFSET NAME).
  3432. OFFSET is an integer number of seconds ahead of UTC (east of Greenwich).
  3433.     A negative value means west of Greenwich.
  3434. NAME is a string giving the name of the time zone.
  3435. If an argument is given, it specifies when the time zone offset is determined
  3436. instead of using the current time.  The argument should have the form:
  3437.   (HIGH . LOW)
  3438. or the form:
  3439.   (HIGH LOW . IGNORED).
  3440. Thus, you can use times obtained from `current-time'
  3441. and from `file-attributes'.
  3442.  
  3443. Some operating systems cannot provide all this information to Emacs;
  3444. in this case, `current-time-zone' returns a list containing nil for
  3445. the data it can't find.
  3446.  
  3447. arguments: (&optional specified-time)Finsert
  3448. Insert the arguments, either strings or characters, at point.
  3449. Point moves forward so that it ends up after the inserted text.
  3450. Any other markers at the point of insertion remain before the text.Finsert-and-inherit
  3451. Insert the arguments at point, inheriting properties from adjoining text.
  3452. Point moves forward so that it ends up after the inserted text.
  3453. Any other markers at the point of insertion remain before the text.Finsert-before-markers
  3454. Insert strings or characters at point, relocating markers after the text.
  3455. Point moves forward so that it ends up after the inserted text.
  3456. Any other markers at the point of insertion also end up after the text.Finsert-before-markers-and-inherit
  3457. Insert text at point, relocating markers and inheriting properties.
  3458. Point moves forward so that it ends up after the inserted text.
  3459. Any other markers at the point of insertion also end up after the text.Finsert-char
  3460. Insert COUNT (second arg) copies of CHAR (first arg).
  3461. Point and all markers are affected as in the function `insert'.
  3462. Both arguments are required.
  3463.  
  3464. arguments: (chr count)Fbuffer-substring
  3465. Return the contents of part of the current buffer as a string.
  3466. The two arguments START and END are character positions;
  3467. they can be in either order.
  3468.  
  3469. arguments: (b e)Fbuffer-string
  3470. Return the contents of the current buffer as a string.
  3471.  
  3472. arguments: ()Finsert-buffer-substring
  3473. Insert before point a substring of the contents of buffer BUFFER.
  3474. BUFFER may be a buffer or a buffer name.
  3475. Arguments START and END are character numbers specifying the substring.
  3476. They default to the beginning and the end of BUFFER.
  3477.  
  3478. arguments: (buf &optional b e)Fcompare-buffer-substrings
  3479. Compare two substrings of two buffers; return result as number.
  3480. the value is -N if first string is less after N-1 chars,
  3481. +N if first string is greater after N-1 chars, or 0 if strings match.
  3482. Each substring is represented as three arguments: BUFFER, START and END.
  3483. That makes six args in all, three for each substring.
  3484.  
  3485. The value of `case-fold-search' in the current buffer
  3486. determines whether case is significant or ignored.
  3487.  
  3488. arguments: (buffer1 start1 end1 buffer2 start2 end2)Fsubst-char-in-region
  3489. From START to END, replace FROMCHAR with TOCHAR each time it occurs.
  3490. If optional arg NOUNDO is non-nil, don't record this change for undo
  3491. and don't mark the buffer as really changed.
  3492.  
  3493. arguments: (start end fromchar tochar &optional noundo)Ftranslate-region
  3494. From START to END, translate characters according to TABLE.
  3495. TABLE is a string; the Nth character in it is the mapping
  3496. for the character with code N.  Returns the number of characters changed.
  3497.  
  3498. arguments: (start end table)Fdelete-region
  3499. Delete the text between point and mark.
  3500. When called from a program, expects two arguments,
  3501. positions (integers or markers) specifying the stretch to be deleted.
  3502.  
  3503. arguments: (b e)Fwiden
  3504. Remove restrictions (narrowing) from current buffer.
  3505. This allows the buffer's full text to be seen and edited.
  3506.  
  3507. arguments: ()Fnarrow-to-region
  3508. Restrict editing in this buffer to the current region.
  3509. The rest of the text becomes temporarily invisible and untouchable
  3510. but is not deleted; if you save the buffer in a file, the invisible
  3511. text is included in the file.  \[widen] makes all visible again.
  3512. See also `save-restriction'.
  3513.  
  3514. When calling from a program, pass two arguments; positions (integers
  3515. or markers) bounding the text that should remain visible.
  3516.  
  3517. arguments: (b e)Fsave-restriction
  3518. Execute BODY, saving and restoring current buffer's restrictions.
  3519. The buffer's restrictions make parts of the beginning and end invisible.
  3520. (They are set up with `narrow-to-region' and eliminated with `widen'.)
  3521. This special form, `save-restriction', saves the current buffer's restrictions
  3522. when it is entered, and restores them when it is exited.
  3523. So any `narrow-to-region' within BODY lasts only until the end of the form.
  3524. The old restrictions settings are restored
  3525. even in case of abnormal exit (throw or error).
  3526.  
  3527. The value returned is the value of the last form in BODY.
  3528.  
  3529. `save-restriction' can get confused if, within the BODY, you widen
  3530. and then make changes outside the area within the saved restrictions.
  3531.  
  3532. Note: if you are using both `save-excursion' and `save-restriction',
  3533. use `save-excursion' outermost:
  3534.     (save-excursion (save-restriction ...))Fmessage
  3535. Print a one-line message at the bottom of the screen.
  3536. The first argument is a control string.
  3537. It may contain %s or %d or %c to print successive following arguments.
  3538. %s means print an argument as a string, %d means print as number in decimal,
  3539. %c means print a number as a single character.
  3540. The argument used by %s must be a string or a symbol;
  3541. the argument used by %d or %c must be a number.
  3542. If the first argument is nil, clear any existing message; let the
  3543. minibuffer contents show.Fformat
  3544. Format a string out of a control-string and arguments.
  3545. The first argument is a control string.
  3546. The other arguments are substituted into it to make the result, a string.
  3547. It may contain %-sequences meaning to substitute the next argument.
  3548. %s means print a string argument.  Actually, prints any object, with `princ'.
  3549. %d means print as number in decimal (%o octal, %x hex).
  3550. %c means print a number as a single character.
  3551. %S means print any object as an s-expression (using prin1).
  3552.   The argument used for %d, %o, %x or %c must be a number.
  3553. Use %% to put a single % into the output.Fchar-equal
  3554. Return t if two characters match, optionally ignoring case.
  3555. Both arguments must be characters (i.e. integers).
  3556. Case is ignored if `case-fold-search' is non-nil in the current buffer.
  3557.  
  3558. arguments: (c1 c2)Finteractive
  3559. Specify a way of parsing arguments for interactive use of a function.
  3560. For example, write
  3561.   (defun foo (arg) "Doc string" (interactive "p") ...use arg...)
  3562. to make ARG be the prefix argument when `foo' is called as a command.
  3563. The "call" to `interactive' is actually a declaration rather than a function;
  3564.  it tells `call-interactively' how to read arguments
  3565.  to pass to the function.
  3566. When actually called, `interactive' just returns nil.
  3567.  
  3568. The argument of `interactive' is usually a string containing a code letter
  3569.  followed by a prompt.  (Some code letters do not use I/O to get
  3570.  the argument and do not need prompts.)  To prompt for multiple arguments,
  3571.  give a code letter, its prompt, a newline, and another code letter, etc.
  3572.  Prompts are passed to format, and may use % escapes to print the
  3573.  arguments that have already been read.
  3574. If the argument is not a string, it is evaluated to get a list of
  3575.  arguments to pass to the function.
  3576. Just `(interactive)' means pass no args when calling interactively.
  3577.  
  3578. Code letters available are:
  3579. a -- Function name: symbol with a function definition.
  3580. b -- Name of existing buffer.
  3581. B -- Name of buffer, possibly nonexistent.
  3582. c -- Character.
  3583. C -- Command name: symbol with interactive function definition.
  3584. d -- Value of point as number.  Does not do I/O.
  3585. D -- Directory name.
  3586. e -- Parametrized event (i.e., one that's a list) that invoked this command.
  3587.      If used more than once, the Nth `e' returns the Nth parameterized event.
  3588.      This skips events that are integers or symbols.
  3589. f -- Existing file name.
  3590. F -- Possibly nonexistent file name.
  3591. k -- Key sequence (string).
  3592. m -- Value of mark as number.  Does not do I/O.
  3593. n -- Number read using minibuffer.
  3594. N -- Prefix arg converted to number, or if none, do like code `n'.
  3595. p -- Prefix arg converted to number.  Does not do I/O.
  3596. P -- Prefix arg in raw form.  Does not do I/O.
  3597. r -- Region: point and mark as 2 numeric args, smallest first.  Does no I/O.
  3598. s -- Any string.
  3599. S -- Any symbol.
  3600. v -- Variable name: symbol that is user-variable-p.
  3601. x -- Lisp expression read but not evaluated.
  3602. X -- Lisp expression read and evaluated.
  3603. In addition, if the string begins with `*'
  3604.  then an error is signaled if the buffer is read-only.
  3605.  This happens before reading any arguments.
  3606. If the string begins with `@', then Emacs searches the key sequence
  3607.  which invoked the command for its first mouse click (or any other
  3608.  event which specifies a window), and selects that window before
  3609.  reading any arguments.  You may use both `@' and `*'; they are
  3610.  processed in the order that they appear.
  3611.  
  3612. arguments: (args)Fcall-interactively
  3613. Call FUNCTION, reading args according to its interactive calling specs.
  3614. The function contains a specification of how to do the argument reading.
  3615. In the case of user-defined functions, this is specified by placing a call
  3616. to the function `interactive' at the top level of the function body.
  3617. See `interactive'.
  3618.  
  3619. Optional second arg RECORD-FLAG non-nil
  3620. means unconditionally put this command in the command-history.
  3621. Otherwise, this is done only if an arg is read using the minibuffer.
  3622.  
  3623. arguments: (function &optional record)Fprefix-numeric-value
  3624. Return numeric meaning of raw prefix argument ARG.
  3625. A raw prefix argument is what you get from `(interactive "P")'.
  3626. Its numeric meaning is what you would get from `(interactive "p")'.
  3627.  
  3628. arguments: (raw)Vprefix-arg
  3629. The value of the prefix argument for the next editing command.
  3630. It may be a number, or the symbol `-' for just a minus sign as arg,
  3631. or a list whose car is a number for just one or more C-U's
  3632. or nil if no argument has been specified.
  3633.  
  3634. You cannot examine this variable to find the argument for this command
  3635. since it has been set to nil by the time you can look.
  3636. Instead, you should use the variable `current-prefix-arg', although
  3637. normally commands can get this prefix argument with (interactive "P").Vcurrent-prefix-arg
  3638. The value of the prefix argument for this editing command.
  3639. It may be a number, or the symbol `-' for just a minus sign as arg,
  3640. or a list whose car is a number for just one or more C-U's
  3641. or nil if no argument has been specified.
  3642. This is what `(interactive "P")' returns.Vcommand-history
  3643. List of recent commands that read arguments from terminal.
  3644. Each command is represented as a form to evaluate.Vcommand-debug-status
  3645. Debugging status of current interactive command.
  3646. Bound each time `call-interactively' is called;
  3647. may be set by the debugger as a reminder for itself.Vmark-even-if-inactive
  3648. *Non-nil means you can use the mark even when inactive.
  3649. This option makes a difference in Transient Mark mode.
  3650. When the option is non-nil, deactivation of the mark
  3651. turns off region highlighting, but commands that use the mark
  3652. behave as if the mark were still active.For
  3653. Eval args until one of them yields non-nil, then return that value.
  3654. The remaining args are not evalled at all.
  3655. If all args return nil, return nil.Fand
  3656. Eval args until one of them yields nil, then return nil.
  3657. The remaining args are not evalled at all.
  3658. If no arg yields nil, return the last arg's value.Fif
  3659. (if COND THEN ELSE...): if COND yields non-nil, do THEN, else do ELSE...
  3660. Returns the value of THEN or the value of the last of the ELSE's.
  3661. THEN must be one expression, but ELSE... can be zero or more expressions.
  3662. If COND yields nil, and there are no ELSE's, the value is nil.Fcond
  3663. (cond CLAUSES...): try each clause until one succeeds.
  3664. Each clause looks like (CONDITION BODY...).  CONDITION is evaluated
  3665. and, if the value is non-nil, this clause succeeds:
  3666. then the expressions in BODY are evaluated and the last one's
  3667. value is the value of the cond-form.
  3668. If no clause succeeds, cond returns nil.
  3669. If a clause has one element, as in (CONDITION),
  3670. CONDITION's value if non-nil is returned from the cond-form.Fprogn
  3671. (progn BODY...): eval BODY forms sequentially and return value of last one.Fprog1
  3672. (prog1 FIRST BODY...): eval FIRST and BODY sequentially; value from FIRST.
  3673. The value of FIRST is saved during the evaluation of the remaining args,
  3674. whose values are discarded.Fprog2
  3675. (prog1 X Y BODY...): eval X, Y and BODY sequentially; value from Y.
  3676. The value of Y is saved during the evaluation of the remaining args,
  3677. whose values are discarded.Fsetq
  3678. (setq SYM VAL SYM VAL ...): set each SYM to the value of its VAL.
  3679. The SYMs are not evaluated.  Thus (setq x y) sets x to the value of y.
  3680. Each SYM is set before the next VAL is computed.Fquote
  3681. Return the argument, without evaluating it.  `(quote x)' yields `x'.Ffunction
  3682. Like `quote', but preferred for objects which are functions.
  3683. In byte compilation, `function' causes its argument to be compiled.
  3684. `quote' cannot do that.Finteractive-p
  3685. Return t if function in which this appears was called interactively.
  3686. This means that the function was called with call-interactively (which
  3687. includes being called as the binding of a key)
  3688. and input is currently coming from the keyboard (not in keyboard macro).
  3689.  
  3690. arguments: ()Fdefun
  3691. (defun NAME ARGLIST [DOCSTRING] BODY...): define NAME as a function.
  3692. The definition is (lambda ARGLIST [DOCSTRING] BODY...).
  3693. See also the function `interactive'.Fdefmacro
  3694. (defmacro NAME ARGLIST [DOCSTRING] BODY...): define NAME as a macro.
  3695. The definition is (macro lambda ARGLIST [DOCSTRING] BODY...).
  3696. When the macro is called, as in (NAME ARGS...),
  3697. the function (lambda ARGLIST BODY...) is applied to
  3698. the list ARGS... as it appears in the expression,
  3699. and the result should be a form to be evaluated instead of the original.Fdefvar
  3700. (defvar SYMBOL INITVALUE DOCSTRING): define SYMBOL as a variable.
  3701. You are not required to define a variable in order to use it,
  3702. but the definition can supply documentation and an initial value
  3703. in a way that tags can recognize.
  3704.  
  3705. INITVALUE is evaluated, and used to set SYMBOL, only if SYMBOL's value is void.
  3706. If SYMBOL is buffer-local, its default value is what is set;
  3707.  buffer-local values are not affected.
  3708. INITVALUE and DOCSTRING are optional.
  3709. If DOCSTRING starts with *, this variable is identified as a user option.
  3710.  This means that M-x set-variable and M-x edit-options recognize it.
  3711. If INITVALUE is missing, SYMBOL's value is not set.Fdefconst
  3712. (defconst SYMBOL INITVALUE DOCSTRING): define SYMBOL as a constant variable.
  3713. The intent is that programs do not change this value, but users may.
  3714. Always sets the value of SYMBOL to the result of evalling INITVALUE.
  3715. If SYMBOL is buffer-local, its default value is what is set;
  3716.  buffer-local values are not affected.
  3717. DOCSTRING is optional.
  3718. If DOCSTRING starts with *, this variable is identified as a user option.
  3719.  This means that M-x set-variable and M-x edit-options recognize it.
  3720.  
  3721. Note: do not use `defconst' for user options in libraries that are not
  3722. normally loaded, since it is useful for users to be able to specify
  3723. their own values for such variables before loading the library.
  3724. Since `defconst' unconditionally assigns the variable,
  3725. it would override the user's choice.Fuser-variable-p
  3726. Returns t if VARIABLE is intended to be set and modified by users.
  3727. (The alternative is a variable used internally in a Lisp program.)
  3728. Determined by whether the first character of the documentation
  3729. for the variable is "*"
  3730.  
  3731. arguments: (variable)Flet*
  3732. (let* VARLIST BODY...): bind variables according to VARLIST then eval BODY.
  3733. The value of the last form in BODY is returned.
  3734. Each element of VARLIST is a symbol (which is bound to nil)
  3735. or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).
  3736. Each VALUEFORM can refer to the symbols already bound by this VARLIST.Flet
  3737. (let VARLIST BODY...): bind variables according to VARLIST then eval BODY.
  3738. The value of the last form in BODY is returned.
  3739. Each element of VARLIST is a symbol (which is bound to nil)
  3740. or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).
  3741. All the VALUEFORMs are evalled before any symbols are bound.Fwhile
  3742. (while TEST BODY...): if TEST yields non-nil, eval BODY... and repeat.
  3743. The order of execution is thus TEST, BODY, TEST, BODY and so on
  3744. until TEST returns nil.Fmacroexpand
  3745. Return result of expanding macros at top level of FORM.
  3746. If FORM is not a macro call, it is returned unchanged.
  3747. Otherwise, the macro is expanded and the expansion is considered
  3748. in place of FORM.  When a non-macro-call results, it is returned.
  3749.  
  3750. The second optional arg ENVIRONMENT species an environment of macro
  3751. definitions to shadow the loaded ones for use in file byte-compilation.
  3752.  
  3753. arguments: (form &optional env)Fcatch
  3754. (catch TAG BODY...): eval BODY allowing nonlocal exits using `throw'.
  3755. TAG is evalled to get the tag to use.  Then the BODY is executed.
  3756. Within BODY, (throw TAG) with same tag exits BODY and exits this `catch'.
  3757. If no throw happens, `catch' returns the value of the last BODY form.
  3758. If a throw happens, it specifies the value to return from `catch'.Fthrow
  3759. (throw TAG VALUE): throw to the catch for TAG and return VALUE from it.
  3760. Both TAG and VALUE are evalled.
  3761.  
  3762. arguments: (tag val)Funwind-protect
  3763. Do BODYFORM, protecting with UNWINDFORMS.
  3764. Usage looks like (unwind-protect BODYFORM UNWINDFORMS...).
  3765. If BODYFORM completes normally, its value is returned
  3766. after executing the UNWINDFORMS.
  3767. If BODYFORM exits nonlocally, the UNWINDFORMS are executed anyway.Fcondition-case
  3768. Regain control when an error is signaled.
  3769. Usage looks like (condition-case VAR BODYFORM HANDLERS...).
  3770. executes BODYFORM and returns its value if no error happens.
  3771. Each element of HANDLERS looks like (CONDITION-NAME BODY...)
  3772. where the BODY is made of Lisp expressions.
  3773.  
  3774. A handler is applicable to an error
  3775. if CONDITION-NAME is one of the error's condition names.
  3776. If an error happens, the first applicable handler is run.
  3777.  
  3778. When a handler handles an error,
  3779. control returns to the condition-case and the handler BODY... is executed
  3780. with VAR bound to (SIGNALED-CONDITIONS . SIGNAL-DATA).
  3781. VAR may be nil; then you do not get access to the signal information.
  3782.  
  3783. The value of the last BODY form is returned from the condition-case.
  3784. See also the function `signal' for more info.Fsignal
  3785. Signal an error.  Args are SIGNAL-NAME, and associated DATA.
  3786. This function does not return.
  3787.  
  3788. A signal name is a symbol with an `error-conditions' property
  3789. that is a list of condition names.
  3790. A handler for any of those names will get to handle this signal.
  3791. The symbol `error' should normally be one of them.
  3792.  
  3793. DATA should be a list.  Its elements are printed as part of the error message.
  3794. If the signal is handled, DATA is made available to the handler.
  3795. See also the function `condition-case'.
  3796.  
  3797. arguments: (sig data)Fcommandp
  3798. T if FUNCTION makes provisions for interactive calling.
  3799. This means it contains a description for how to read arguments to give it.
  3800. The value is nil for an invalid function or a symbol with no function
  3801. definition.
  3802.  
  3803. Interactively callable functions include strings and vectors (treated
  3804. as keyboard macros), lambda-expressions that contain a top-level call
  3805. to `interactive', autoload definitions made by `autoload' with non-nil
  3806. fourth argument, and some of the built-in functions of Lisp.
  3807.  
  3808. Also, a symbol satisfies `commandp' if its function definition does so.
  3809.  
  3810. arguments: (function)Fautoload
  3811. Define FUNCTION to autoload from FILE.
  3812. FUNCTION is a symbol; FILE is a file name string to pass to `load'.
  3813. Third arg DOCSTRING is documentation for the function.
  3814. Fourth arg INTERACTIVE if non-nil says function can be called interactively.
  3815. Fifth arg TYPE indicates the type of the object:
  3816.    nil or omitted says FUNCTION is a function,
  3817.    `keymap' says FUNCTION is really a keymap, and
  3818.    `macro' or t says FUNCTION is really a macro.
  3819. Third through fifth args give info about the real definition.
  3820. They default to nil.
  3821. If FUNCTION is already defined other than as an autoload,
  3822. this does nothing and returns nil.
  3823.  
  3824. arguments: (function file &optional docstring interactive type)Feval
  3825. Evaluate FORM and return its value.
  3826.  
  3827. arguments: (form)Fapply
  3828. Call FUNCTION with our remaining args, using our last arg as list of args.
  3829. Thus, (apply '+ 1 2 '(3 4)) returns 10.Ffuncall
  3830. Call first argument as a function, passing remaining arguments to it.
  3831. Thus, (funcall 'cons 'x 'y) returns (x . y).Fbacktrace-debug
  3832. Set the debug-on-exit flag of eval frame LEVEL levels down to FLAG.
  3833. The debugger is entered when that frame exits, if the flag is non-nil.
  3834.  
  3835. arguments: (level flag)Fbacktrace
  3836. Print a trace of Lisp function calls currently active.
  3837. Output stream used is value of `standard-output'.
  3838.  
  3839. arguments: ()Fbacktrace-frame
  3840. Return the function and arguments N frames up from current execution point.
  3841. If that frame has not evaluated the arguments yet (or is a special form),
  3842. the value is (nil FUNCTION ARG-FORMS...).
  3843. If that frame has evaluated its arguments and called its function already,
  3844. the value is (t FUNCTION ARG-VALUES...).
  3845. A &rest arg is represented as the tail of the list ARG-VALUES.
  3846. FUNCTION is whatever was supplied as car of evaluated list,
  3847. or a lambda expression for macro calls.
  3848. If N is more than the number of frames, the value is nil.
  3849.  
  3850. arguments: (nframes)Vmax-specpdl-size
  3851. Limit on number of Lisp variable bindings & unwind-protects before error.Vmax-lisp-eval-depth
  3852. Limit on depth in `eval', `apply' and `funcall' before error.
  3853. This limit is to catch infinite recursions for you before they cause
  3854. actual stack overflow in C, which would be fatal for Emacs.
  3855. You can safely make it considerably larger than its default value,
  3856. if that proves inconveniently small.Vquit-flag
  3857. Non-nil causes `eval' to abort, unless `inhibit-quit' is non-nil.
  3858. Typing C-G sets `quit-flag' non-nil, regardless of `inhibit-quit'.Vinhibit-quit
  3859. Non-nil inhibits C-g quitting from happening immediately.
  3860. Note that `quit-flag' will still be set by typing C-g,
  3861. so a quit will be signalled as soon as `inhibit-quit' is nil.
  3862. To prevent this happening, set `quit-flag' to nil
  3863. before making `inhibit-quit' nil.Vstack-trace-on-error
  3864. *Non-nil means automatically display a backtrace buffer
  3865. after any error that is handled by the editor command loop.
  3866. If the value is a list, an error only means to display a backtrace
  3867. if one of its condition symbols appears in the list.Vdebug-on-error
  3868. *Non-nil means enter debugger if an error is signaled.
  3869. Does not apply to errors handled by `condition-case'.
  3870. If the value is a list, an error only means to enter the debugger
  3871. if one of its condition symbols appears in the list.
  3872. See also variable `debug-on-quit'.Vdebug-on-quit
  3873. *Non-nil means enter debugger if quit is signaled (C-G, for example).
  3874. Does not apply if quit is handled by a `condition-case'.Vdebug-on-next-call
  3875. Non-nil means enter debugger before next `eval', `apply' or `funcall'.Vdebugger
  3876. Function to call to invoke debugger.
  3877. If due to frame exit, args are `exit' and the value being returned;
  3878.  this function's value will be returned instead of that.
  3879. If due to error, args are `error' and a list of the args to `signal'.
  3880. If due to `apply' or `funcall' entry, one arg, `lambda'.
  3881. If due to `eval' entry, one arg, t.Vmocklisp-arguments
  3882. While in a mocklisp function, the list of its unevaluated args.Vrun-hooks
  3883. Set to the function `run-hooks', if that function has been defined.
  3884. Otherwise, nil (in a bare Emacs without preloaded Lisp code).Facos
  3885. Return the inverse cosine of ARG.
  3886.  
  3887. arguments: (arg)Fasin
  3888. Return the inverse sine of ARG.
  3889.  
  3890. arguments: (arg)Fatan
  3891. Return the inverse tangent of ARG.
  3892.  
  3893. arguments: (arg)Fcos
  3894. Return the cosine of ARG.
  3895.  
  3896. arguments: (arg)Fsin
  3897. Return the sine of ARG.
  3898.  
  3899. arguments: (arg)Ftan
  3900. Return the tangent of ARG.
  3901.  
  3902. arguments: (arg)Fbessel-j0
  3903. Return the bessel function j0 of ARG.
  3904.  
  3905. arguments: (arg)Fbessel-j1
  3906. Return the bessel function j1 of ARG.
  3907.  
  3908. arguments: (arg)Fbessel-jn
  3909. Return the order N bessel function output jn of ARG.
  3910. The first arg (the order) is truncated to an integer.
  3911.  
  3912. arguments: (arg1 arg2)Fbessel-y0
  3913. Return the bessel function y0 of ARG.
  3914.  
  3915. arguments: (arg)Fbessel-y1
  3916. Return the bessel function y1 of ARG.
  3917.  
  3918. arguments: (arg)Fbessel-yn
  3919. Return the order N bessel function output yn of ARG.
  3920. The first arg (the order) is truncated to an integer.
  3921.  
  3922. arguments: (arg1 arg2)Ferf
  3923. Return the mathematical error function of ARG.
  3924.  
  3925. arguments: (arg)Ferfc
  3926. Return the complementary error function of ARG.
  3927.  
  3928. arguments: (arg)Flog-gamma
  3929. Return the log gamma of ARG.
  3930.  
  3931. arguments: (arg)Fcube-root
  3932. Return the cube root of ARG.
  3933.  
  3934. arguments: (arg)Fexp
  3935. Return the exponential base e of ARG.
  3936.  
  3937. arguments: (arg)Fexpt
  3938. Return the exponential X ** Y.
  3939.  
  3940. arguments: (arg1 arg2)Flog
  3941. Return the natural logarithm of ARG.
  3942. If second optional argument BASE is given, return log ARG using that base.
  3943.  
  3944. arguments: (arg &optional base)Flog10
  3945. Return the logarithm base 10 of ARG.
  3946.  
  3947. arguments: (arg)Fsqrt
  3948. Return the square root of ARG.
  3949.  
  3950. arguments: (arg)Facosh
  3951. Return the inverse hyperbolic cosine of ARG.
  3952.  
  3953. arguments: (arg)Fasinh
  3954. Return the inverse hyperbolic sine of ARG.
  3955.  
  3956. arguments: (arg)Fatanh
  3957. Return the inverse hyperbolic tangent of ARG.
  3958.  
  3959. arguments: (arg)Fcosh
  3960. Return the hyperbolic cosine of ARG.
  3961.  
  3962. arguments: (arg)Fsinh
  3963. Return the hyperbolic sine of ARG.
  3964.  
  3965. arguments: (arg)Ftanh
  3966. Return the hyperbolic tangent of ARG.
  3967.  
  3968. arguments: (arg)Fabs
  3969. Return the absolute value of ARG.
  3970.  
  3971. arguments: (arg)Ffloat
  3972. Return the floating point number equal to ARG.
  3973.  
  3974. arguments: (arg)Flogb
  3975. Returns largest integer <= the base 2 log of the magnitude of ARG.
  3976. This is the same as the exponent of a float.
  3977.  
  3978. arguments: (arg)Fceiling
  3979. Return the smallest integer no less than ARG.  (Round toward +inf.)
  3980.  
  3981. arguments: (arg)Ffloor
  3982. Return the largest integer no greater than ARG.  (Round towards -inf.)
  3983. With optional DIVISOR, return the largest integer no greater than ARG/DIVISOR.
  3984.  
  3985. arguments: (arg &optional divisor)Fround
  3986. Return the nearest integer to ARG.
  3987.  
  3988. arguments: (arg)Ftruncate
  3989. Truncate a floating point number to an int.
  3990. Rounds the value toward zero.
  3991.  
  3992. arguments: (arg)Ffceiling
  3993. Return the smallest integer no less than ARG, as a float.
  3994. (Round toward +inf.)
  3995.  
  3996. arguments: (arg)Fffloor
  3997. Return the largest integer no greater than ARG, as a float.
  3998. (Round towards -inf.)
  3999.  
  4000. arguments: (arg)Ffround
  4001. Return the nearest integer to ARG, as a float.
  4002.  
  4003. arguments: (arg)Fftruncate
  4004. Truncate a floating point number to an integral float value.
  4005. Rounds the value toward zero.
  4006.  
  4007. arguments: (arg)Fidentity
  4008. Return the argument unchanged.
  4009.  
  4010. arguments: (arg)Frandom
  4011. Return a pseudo-random number.
  4012. On most systems all integers representable in Lisp are equally likely.
  4013.   This is 24 bits' worth.
  4014. With argument N, return random number in interval [0,N).
  4015. With argument t, set the random number seed from the current time and pid.
  4016.  
  4017. arguments: (&optional limit)Flength
  4018. Return the length of vector, list or string SEQUENCE.
  4019. A byte-code function object is also allowed.
  4020.  
  4021. arguments: (obj)Fstring-equal
  4022. T if two strings have identical contents.
  4023. Case is significant.
  4024. Symbols are also allowed; their print names are used instead.
  4025.  
  4026. arguments: (s1 s2)Fstring-lessp
  4027. T if first arg string is less than second in lexicographic order.
  4028. Case is significant.
  4029. Symbols are also allowed; their print names are used instead.
  4030.  
  4031. arguments: (s1 s2)Fappend
  4032. Concatenate all the arguments and make the result a list.
  4033. The result is a list whose elements are the elements of all the arguments.
  4034. Each argument may be a list, vector or string.
  4035. The last argument is not copied, just used as the tail of the new list.Fconcat
  4036. Concatenate all the arguments and make the result a string.
  4037. The result is a string whose elements are the elements of all the arguments.
  4038. Each argument may be a string, a list of numbers, or a vector of numbers.Fvconcat
  4039. Concatenate all the arguments and make the result a vector.
  4040. The result is a vector whose elements are the elements of all the arguments.
  4041. Each argument may be a list, vector or string.Fcopy-sequence
  4042. Return a copy of a list, vector or string.
  4043. The elements of a list or vector are not copied; they are shared
  4044. with the original.
  4045.  
  4046. arguments: (arg)Fcopy-alist
  4047. Return a copy of ALIST.
  4048. This is an alist which represents the same mapping from objects to objects,
  4049. but does not share the alist structure with ALIST.
  4050. The objects mapped (cars and cdrs of elements of the alist)
  4051. are shared, however.
  4052. Elements of ALIST that are not conses are also shared.
  4053.  
  4054. arguments: (alist)Fsubstring
  4055. Return a substring of STRING, starting at index FROM and ending before TO.
  4056. TO may be nil or omitted; then the substring runs to the end of STRING.
  4057. If FROM or TO is negative, it counts from the end.
  4058.  
  4059. arguments: (string from &optional to)Fnthcdr
  4060. Take cdr N times on LIST, returns the result.
  4061.  
  4062. arguments: (n list)Fnth
  4063. Return the Nth element of LIST.
  4064. N counts from zero.  If LIST is not that long, nil is returned.
  4065.  
  4066. arguments: (n list)Felt
  4067. Return element of SEQUENCE at index N.
  4068.  
  4069. arguments: (seq n)Fmember
  4070. Return non-nil if ELT is an element of LIST.  Comparison done with EQUAL.
  4071. The value is actually the tail of LIST whose car is ELT.
  4072.  
  4073. arguments: (elt list)Fmemq
  4074. Return non-nil if ELT is an element of LIST.  Comparison done with EQ.
  4075. The value is actually the tail of LIST whose car is ELT.
  4076.  
  4077. arguments: (elt list)Fassq
  4078. Return non-nil if ELT is `eq' to the car of an element of LIST.
  4079. The value is actually the element of LIST whose car is ELT.
  4080. Elements of LIST that are not conses are ignored.
  4081.  
  4082. arguments: (key list)Fassoc
  4083. Return non-nil if ELT is `equal' to the car of an element of LIST.
  4084. The value is actually the element of LIST whose car is ELT.
  4085.  
  4086. arguments: (key list)Frassq
  4087. Return non-nil if ELT is `eq' to the cdr of an element of LIST.
  4088. The value is actually the element of LIST whose cdr is ELT.
  4089.  
  4090. arguments: (key list)Fdelq
  4091. Delete by side effect any occurrences of ELT as a member of LIST.
  4092. The modified LIST is returned.  Comparison is done with `eq'.
  4093. If the first member of LIST is ELT, there is no way to remove it by side effect;
  4094. therefore, write `(setq foo (delq element foo))'
  4095. to be sure of changing the value of `foo'.
  4096.  
  4097. arguments: (elt list)Fdelete
  4098. Delete by side effect any occurrences of ELT as a member of LIST.
  4099. The modified LIST is returned.  Comparison is done with `equal'.
  4100. If the first member of LIST is ELT, there is no way to remove it by side effect;
  4101. therefore, write `(setq foo (delete element foo))'
  4102. to be sure of changing the value of `foo'.
  4103.  
  4104. arguments: (elt list)Fnreverse
  4105. Reverse LIST by modifying cdr pointers.
  4106. Returns the beginning of the reversed list.
  4107.  
  4108. arguments: (list)Freverse
  4109. Reverse LIST, copying.  Returns the beginning of the reversed list.
  4110. See also the function `nreverse', which is used more often.
  4111.  
  4112. arguments: (list)Fsort
  4113. Sort LIST, stably, comparing elements using PREDICATE.
  4114. Returns the sorted list.  LIST is modified by side effects.
  4115. PREDICATE is called with two elements of LIST, and should return T
  4116. if the first element is "less" than the second.
  4117.  
  4118. arguments: (list pred)Fget
  4119. Return the value of SYMBOL's PROPNAME property.
  4120. This is the last VALUE stored with `(put SYMBOL PROPNAME VALUE)'.
  4121.  
  4122. arguments: (sym prop)Fput
  4123. Store SYMBOL's PROPNAME property with value VALUE.
  4124. It can be retrieved with `(get SYMBOL PROPNAME)'.
  4125.  
  4126. arguments: (sym prop val)Fequal
  4127. T if two Lisp objects have similar structure and contents.
  4128. They must have the same data type.
  4129. Conses are compared by comparing the cars and the cdrs.
  4130. Vectors and strings are compared element by element.
  4131. Numbers are compared by value, but integers cannot equal floats.
  4132.  (Use `=' if you want integers and floats to be able to be equal.)
  4133. Symbols must match exactly.
  4134.  
  4135. arguments: (o1 o2)Ffillarray
  4136. Store each element of ARRAY with ITEM.  ARRAY is a vector or string.
  4137.  
  4138. arguments: (array item)Fnconc
  4139. Concatenate any number of lists by altering them.
  4140. Only the last argument is not altered, and need not be a list.Fmapconcat
  4141. Apply FN to each element of SEQ, and concat the results as strings.
  4142. In between each pair of results, stick in SEP.
  4143. Thus, " " as SEP results in spaces between the values return by FN.
  4144.  
  4145. arguments: (fn seq sep)Fmapcar
  4146. Apply FUNCTION to each element of SEQUENCE, and make a list of the results.
  4147. The result is a list just as long as SEQUENCE.
  4148. SEQUENCE may be a list, a vector or a string.
  4149.  
  4150. arguments: (fn seq)Fy-or-n-p
  4151. Ask user a "y or n" question.  Return t if answer is "y".
  4152. Takes one argument, which is the string to display to ask the question.
  4153. It should end in a space; `y-or-n-p' adds `(y or n) ' to it.
  4154. No confirmation of the answer is requested; a single character is enough.
  4155. Also accepts Space to mean yes, or Delete to mean no.
  4156.  
  4157. arguments: (prompt)Fyes-or-no-p
  4158. Ask user a yes-or-no question.  Return t if answer is yes.
  4159. Takes one argument, which is the string to display to ask the question.
  4160. It should end in a space; `yes-or-no-p' adds `(yes or no) ' to it.
  4161. The user must confirm the answer with RET,
  4162. and can edit it until it as been confirmed.
  4163.  
  4164. arguments: (prompt)Fload-average
  4165. Return list of 1 minute, 5 minute and 15 minute load averages.
  4166. Each of the three load averages is multiplied by 100,
  4167. then converted to integer.
  4168. If the 5-minute or 15-minute load averages are not available, return a
  4169. shortened list, containing only those averages which are available.
  4170.  
  4171. arguments: ()Ffeaturep
  4172. Returns t if FEATURE is present in this Emacs.
  4173. Use this to conditionalize execution of lisp code based on the presence or
  4174. absence of emacs or environment extensions.
  4175. Use `provide' to declare that a feature is available.
  4176. This function looks at the value of the variable `features'.
  4177.  
  4178. arguments: (feature)Fprovide
  4179. Announce that FEATURE is a feature of the current Emacs.
  4180.  
  4181. arguments: (feature)Frequire
  4182. If feature FEATURE is not loaded, load it from FILENAME.
  4183. If FEATURE is not a member of the list `features', then the feature
  4184. is not loaded; so load the file FILENAME.
  4185. If FILENAME is omitted, the printname of FEATURE is used as the file name.
  4186.  
  4187. arguments: (feature &optional file-name)Vfeatures
  4188. A list of symbols which are the features of the executing emacs.
  4189. Used by `featurep' and `require', and altered by `provide'.Fwrite-char
  4190. Output character CHAR to stream STREAM.
  4191. STREAM defaults to the value of `standard-output' (which see).
  4192.  
  4193. arguments: (ch &optional printcharfun)Fwith-output-to-temp-buffer
  4194. Bind `standard-output' to buffer BUFNAME, eval BODY, then show that buffer.
  4195. The buffer is cleared out initially, and marked as unmodified when done.
  4196. All output done by BODY is inserted in that buffer by default.
  4197. The buffer is displayed in another window, but not selected.
  4198. The value of the last form in BODY is returned.
  4199. If BODY does not finish normally, the buffer BUFNAME is not displayed.
  4200.  
  4201. If variable `temp-buffer-show-function' is non-nil, call it at the end
  4202. to get the buffer displayed.  It gets one argument, the buffer to display.Fterpri
  4203. Output a newline to STREAM.
  4204. If STREAM is omitted or nil, the value of `standard-output' is used.
  4205.  
  4206. arguments: (&optional printcharfun)Fprin1
  4207. Output the printed representation of OBJECT, any Lisp object.
  4208. Quoting characters are printed when needed to make output that `read'
  4209. can handle, whenever this is possible.
  4210. Output stream is STREAM, or value of `standard-output' (which see).
  4211.  
  4212. arguments: (obj &optional printcharfun)Fprin1-to-string
  4213. Return a string containing the printed representation of OBJECT,
  4214. any Lisp object.  Quoting characters are used when needed to make output
  4215. that `read' can handle, whenever this is possible, unless the optional
  4216. second argument NOESCAPE is non-nil.
  4217.  
  4218. arguments: (obj &optional noescape)Fprinc
  4219. Output the printed representation of OBJECT, any Lisp object.
  4220. No quoting characters are used; no delimiters are printed around
  4221. the contents of strings.
  4222. Output stream is STREAM, or value of standard-output (which see).
  4223.  
  4224. arguments: (obj &optional printcharfun)Fprint
  4225. Output the printed representation of OBJECT, with newlines around it.
  4226. Quoting characters are printed when needed to make output that `read'
  4227. can handle, whenever this is possible.
  4228. Output stream is STREAM, or value of `standard-output' (which see).
  4229.  
  4230. arguments: (obj &optional printcharfun)Fexternal-debugging-output
  4231. Write CHARACTER to stderr.
  4232. You can call print while debugging emacs, and pass it this function
  4233. to make it write to the debugging output.
  4234.  
  4235.  
  4236. arguments: (character)Vstandard-output
  4237. Output stream `print' uses by default for outputting a character.
  4238. This may be any function of one argument.
  4239. It may also be a buffer (output is inserted before point)
  4240. or a marker (output is inserted and the marker is advanced)
  4241. or the symbol t (output appears in the minibuffer line).Vfloat-output-format
  4242. The format descriptor string used to print floats.
  4243. This is a %-spec like those accepted by `printf' in C,
  4244. but with some restrictions.  It must start with the two characters `%.'.
  4245. After that comes an integer precision specification,
  4246. and then a letter which controls the format.
  4247. The letters allowed are `e', `f' and `g'.
  4248. Use `e' for exponential notation "DIG.DIGITSeEXPT"
  4249. Use `f' for decimal point notation "DIGITS.DIGITS".
  4250. Use `g' to choose the shorter of those two formats for the number at hand.
  4251. The precision in any of these cases is the number of digits following
  4252. the decimal point.  With `f', a precision of 0 means to omit the
  4253. decimal point.  0 is not allowed with `e' or `g'.
  4254.  
  4255. A value of nil means to use `%.17g'.Vprint-length
  4256. Maximum length of list to print before abbreviating.
  4257. A value of nil means no limit.Vprint-level
  4258. Maximum depth of list nesting to print before abbreviating.
  4259. A value of nil means no limit.Vprint-escape-newlines
  4260. Non-nil means print newlines in strings as backslash-n.Fread-char
  4261. Read a character from the command input (keyboard or macro).
  4262. It is returned as a number.
  4263. If the user generates an event which is not a character (i.e. a mouse
  4264. click or function key event), `read-char' signals an error.  As an
  4265. exception, switch-frame events are put off until non-ASCII events can
  4266. be read.
  4267. If you want to read non-character events, or ignore them, call
  4268. `read-event' or `read-char-exclusive' instead.
  4269.  
  4270. arguments: ()Fread-event
  4271. Read an event object from the input stream.
  4272.  
  4273. arguments: ()Fread-char-exclusive
  4274. Read a character from the command input (keyboard or macro).
  4275. It is returned as a number.  Non character events are ignored.
  4276.  
  4277. arguments: ()Fget-file-char
  4278. Don't use this yourself.
  4279.  
  4280. arguments: ()Fload
  4281. Execute a file of Lisp code named FILE.
  4282. First try FILE with `.elc' appended, then try with `.el',
  4283.  then try FILE unmodified.
  4284. This function searches the directories in `load-path'.
  4285. If optional second arg NOERROR is non-nil,
  4286.  report no error if FILE doesn't exist.
  4287. Print messages at start and end of loading unless
  4288.  optional third arg NOMESSAGE is non-nil.
  4289. If optional fourth arg NOSUFFIX is non-nil, don't try adding
  4290.  suffixes `.elc' or `.el' to the specified name FILE.
  4291. Return t if file exists.
  4292.  
  4293. arguments: (str &optional noerror nomessage nosuffix)Feval-buffer
  4294. Execute the current buffer as Lisp code.
  4295. Programs can pass two arguments, BUFFER and PRINTFLAG.
  4296. BUFFER is the buffer to evaluate (nil means use current buffer).
  4297. PRINTFLAG controls printing of output:
  4298. nil means discard it; anything else is stream for print.
  4299.  
  4300. If there is no error, point does not move.  If there is an error,
  4301. point remains at the end of the last character read from the buffer.
  4302.  
  4303. arguments: (&optional bufname printflag)Feval-current-buffer
  4304. Execute the current buffer as Lisp code.
  4305. Programs can pass argument PRINTFLAG which controls printing of output:
  4306. nil means discard it; anything else is stream for print.
  4307.  
  4308. If there is no error, point does not move.  If there is an error,
  4309. point remains at the end of the last character read from the buffer.
  4310.  
  4311. arguments: (&optional printflag)Feval-region
  4312. Execute the region as Lisp code.
  4313. When called from programs, expects two arguments,
  4314. giving starting and ending indices in the current buffer
  4315. of the text to be executed.
  4316. Programs can pass third argument PRINTFLAG which controls output:
  4317. nil means discard it; anything else is stream for printing it.
  4318.  
  4319. If there is no error, point does not move.  If there is an error,
  4320. point remains at the end of the last character read from the buffer.
  4321.  
  4322. arguments: (b e &optional printflag)Fread
  4323. Read one Lisp expression as text from STREAM, return as Lisp object.
  4324. If STREAM is nil, use the value of `standard-input' (which see).
  4325. STREAM or the value of `standard-input' may be:
  4326.  a buffer (read from point and advance it)
  4327.  a marker (read from where it points and advance it)
  4328.  a function (call it with no arguments for each character,
  4329.      call it with a char as argument to push a char back)
  4330.  a string (takes text from string, starting at the beginning)
  4331.  t (read text line using minibuffer and use it).
  4332.  
  4333. arguments: (&optional readcharfun)Fread-from-string
  4334. Read one Lisp expression which is represented as text by STRING.
  4335. Returns a cons: (OBJECT-READ . FINAL-STRING-INDEX).
  4336. START and END optionally delimit a substring of STRING from which to read;
  4337.  they default to 0 and (length STRING) respectively.
  4338.  
  4339. arguments: (string &optional start end)Fintern
  4340. Return the canonical symbol whose name is STRING.
  4341. If there is none, one is created by this function and returned.
  4342. A second optional argument specifies the obarray to use;
  4343. it defaults to the value of `obarray'.
  4344.  
  4345. arguments: (str &optional obarray)Fintern-soft
  4346. Return the canonical symbol whose name is STRING, or nil if none exists.
  4347. A second optional argument specifies the obarray to use;
  4348. it defaults to the value of `obarray'.
  4349.  
  4350. arguments: (str &optional obarray)Fmapatoms
  4351. Call FUNCTION on every symbol in OBARRAY.
  4352. OBARRAY defaults to the value of `obarray'.
  4353.  
  4354. arguments: (function &optional obarray)Vobarray
  4355. Symbol table for use by `intern' and `read'.
  4356. It is a vector whose length ought to be prime for best results.
  4357. The vector's contents don't make sense if examined from Lisp programs;
  4358. to find all the symbols in an obarray, use `mapatoms'.Vvalues
  4359. List of values of all expressions which were read, evaluated and printed.
  4360. Order is reverse chronological.Vstandard-input
  4361. Stream for read to get input from.
  4362. See documentation of `read' for possible values.Vload-path
  4363. *List of directories to search for files to load.
  4364. Each element is a string (directory name) or nil (try default directory).
  4365. Initialized based on EMACSLOADPATH environment variable, if any,
  4366. otherwise to default specified by file `paths.h' when Emacs was built.Vload-in-progress
  4367. Non-nil iff inside of `load'.Vafter-load-alist
  4368. An alist of expressions to be evalled when particular files are loaded.
  4369. Each element looks like (FILENAME FORMS...).
  4370. When `load' is run and the file-name argument is FILENAME,
  4371. the FORMS in the corresponding element are executed at the end of loading.
  4372.  
  4373. FILENAME must match exactly!  Normally FILENAME is the name of a library,
  4374. with no directory specified, since that is how `load' is normally called.
  4375. An error in FORMS does not undo the load,
  4376. but does prevent execution of the rest of the FORMS.Vload-history
  4377. Alist mapping source file names to symbols and features.
  4378. Each alist element is a list that starts with a file name,
  4379. except for one element (optional) that starts with nil and describes
  4380. definitions evaluated from buffers not visiting files.
  4381. The remaining elements of each list are symbols defined as functions
  4382. or variables, and cons cells `(provide . FEATURE)' and `(require . FEATURE)'.Vcurrent-load-list
  4383. Used for internal purposes by `load'.Fmake-abbrev-table
  4384. Create a new, empty abbrev table object.
  4385.  
  4386. arguments: ()Fclear-abbrev-table
  4387. Undefine all abbrevs in abbrev table TABLE, leaving it empty.
  4388.  
  4389. arguments: (table)Fdefine-abbrev
  4390. Define an abbrev in TABLE named NAME, to expand to EXPANSION and call HOOK.
  4391. NAME and EXPANSION are strings.
  4392. To undefine an abbrev, define it with EXPANSION = nil.
  4393. If HOOK is non-nil, it should be a function of no arguments;
  4394. it is called after EXPANSION is inserted.
  4395.  
  4396. arguments: (table name expansion &optional hook count)Fdefine-global-abbrev
  4397. Define ABBREV as a global abbreviation for EXPANSION.
  4398.  
  4399. arguments: (name expansion)Fdefine-mode-abbrev
  4400. Define ABBREV as a mode-specific abbreviation for EXPANSION.
  4401.  
  4402. arguments: (name expansion)Fabbrev-symbol
  4403. Return the symbol representing abbrev named ABBREV.
  4404. This symbol's name is ABBREV, but it is not the canonical symbol of that name;
  4405. it is interned in an abbrev-table rather than the normal obarray.
  4406. The value is nil if that abbrev is not defined.
  4407. Optional second arg TABLE is abbrev table to look it up in.
  4408. The default is to try buffer's mode-specific abbrev table, then global table.
  4409.  
  4410. arguments: (abbrev &optional table)Fabbrev-expansion
  4411. Return the string that ABBREV expands into in the current buffer.
  4412. Optionally specify an abbrev table as second arg;
  4413. then ABBREV is looked up in that table only.
  4414.  
  4415. arguments: (abbrev &optional table)Fexpand-abbrev
  4416. Expand the abbrev before point, if there is an abbrev there.
  4417. Effective when explicitly called even when `abbrev-mode' is nil.
  4418. Returns t if expansion took place.
  4419.  
  4420. arguments: ()Funexpand-abbrev
  4421. Undo the expansion of the last abbrev that expanded.
  4422. This differs from ordinary undo in that other editing done since then
  4423. is not undone.
  4424.  
  4425. arguments: ()Finsert-abbrev-table-description
  4426. Insert before point a full description of abbrev table named NAME.
  4427. NAME is a symbol whose value is an abbrev table.
  4428. If optional 2nd arg HUMAN is non-nil, a human-readable description is inserted.
  4429. Otherwise the description is an expression,
  4430. a call to `define-abbrev-table', which would
  4431. define the abbrev table NAME exactly as it is currently defined.
  4432.  
  4433. arguments: (name &optional readable)Fdefine-abbrev-table
  4434. Define TABNAME (a symbol) as an abbrev table name.
  4435. Define abbrevs in it according to DEFINITIONS, which is a list of elements
  4436. of the form (ABBREVNAME EXPANSION HOOK USECOUNT).
  4437.  
  4438. arguments: (tabname defns)Vabbrev-table-name-list
  4439. List of symbols whose values are abbrev tables.Vglobal-abbrev-table
  4440. The abbrev table whose abbrevs affect all buffers.
  4441. Each buffer may also have a local abbrev table.
  4442. If it does, the local table overrides the global one
  4443. for any particular abbrev defined in both.Vfundamental-mode-abbrev-table
  4444. The abbrev table of mode-specific abbrevs for Fundamental Mode.Vlast-abbrev
  4445. The abbrev-symbol of the last abbrev expanded.  See `abbrev-symbol'.Vlast-abbrev-text
  4446. The exact text of the last abbrev expanded.
  4447. nil if the abbrev has already been unexpanded.Vlast-abbrev-location
  4448. The location of the start of the last abbrev expanded.Vabbrev-start-location
  4449. Buffer position for `expand-abbrev' to use as the start of the abbrev.
  4450. nil means use the word before point as the abbrev.
  4451. Calling `expand-abbrev' sets this to nil.Vabbrev-start-location-buffer
  4452. Buffer that `abbrev-start-location' has been set for.
  4453. Trying to expand an abbrev in any other buffer clears `abbrev-start-location'.Vlocal-abbrev-table
  4454. Local (mode-specific) abbrev table of current buffer.Vabbrevs-changed
  4455. Set non-nil by defining or altering any word abbrevs.
  4456. This causes `save-some-buffers' to offer to save the abbrevs.Vabbrev-all-caps
  4457. *Set non-nil means expand multi-word abbrevs all caps if abbrev was so.Vpre-abbrev-expand-hook
  4458. Function or functions to be called before abbrev expansion is done.
  4459. This is the first thing that `expand-abbrev' does, and so this may change
  4460. the current abbrev table before abbrev lookup happens.Fsyntax-table-p
  4461. Return t if ARG is a syntax table.
  4462. Any vector of 256 elements will do.
  4463.  
  4464. arguments: (obj)Fsyntax-table
  4465. Return the current syntax table.
  4466. This is the one specified by the current buffer.
  4467.  
  4468. arguments: ()Fstandard-syntax-table
  4469. Return the standard syntax table.
  4470. This is the one used for new buffers.
  4471.  
  4472. arguments: ()Fcopy-syntax-table
  4473. Construct a new syntax table and return it.
  4474. It is a copy of the TABLE, which defaults to the standard syntax table.
  4475.  
  4476. arguments: (&optional table)Fset-syntax-table
  4477. Select a new syntax table for the current buffer.
  4478. One argument, a syntax table.
  4479.  
  4480. arguments: (table)Fchar-syntax
  4481. Return the syntax code of CHAR, described by a character.
  4482. For example, if CHAR is a word constituent, the character `?w' is returned.
  4483. The characters that correspond to various syntax codes
  4484. are listed in the documentation of `modify-syntax-entry'.
  4485.  
  4486. arguments: (ch)Fmodify-syntax-entry
  4487. Set syntax for character CHAR according to string S.
  4488. The syntax is changed only for table TABLE, which defaults to
  4489.  the current buffer's syntax table.
  4490. The first character of S should be one of the following:
  4491.   Space or -  whitespace syntax.    w   word constituent.
  4492.   _           symbol constituent.   .   punctuation.
  4493.   (           open-parenthesis.     )   close-parenthesis.
  4494.   "           string quote.         \   escape.
  4495.   $           paired delimiter.     '   expression quote or prefix operator.
  4496.   <           comment starter.      >   comment ender.
  4497.                   
  4498.   /           character-quote.
  4499. Only single-character comment start and end sequences are represented thus.
  4500. Two-character sequences are represented as described below.
  4501. The second character of S is the matching parenthesis,
  4502.  used only if the first character is `(' or `)'.
  4503. Any additional characters are flags.
  4504. Defined flags are the characters 1, 2, 3, 4, b, and p.
  4505.  1 means C is the start of a two-char comment start sequence.
  4506.  2 means C is the second character of such a sequence.
  4507.  3 means C is the start of a two-char comment end sequence.
  4508.  4 means C is the second character of such a sequence.
  4509.  
  4510. There can be up to two orthogonal comment sequences. This is to support
  4511. language modes such as C++.  By default, all comment sequences are of style
  4512. a, but you can set the comment sequence style to b (on the second character of a
  4513. comment-start, or the first character of a comment-end sequence) by using
  4514. this flag:
  4515.  b means C is part of comment sequence b.
  4516.  
  4517.  p means C is a prefix character for `backward-prefix-chars';
  4518.    such characters are treated as whitespace when they occur
  4519.    between expressions.
  4520.  
  4521. arguments: (char s &optional table)Fdescribe-syntax
  4522. Describe the syntax specifications in the syntax table.
  4523. The descriptions are inserted in a buffer, which is then displayed.
  4524.  
  4525. arguments: ()Fforward-word
  4526. Move point forward ARG words (backward if ARG is negative).
  4527. Normally returns t.
  4528. If an edge of the buffer is reached, point is left there
  4529. and nil is returned.
  4530.  
  4531. arguments: (count)Fforward-comment
  4532. Move forward across up to N comments.  If N is negative, move backward.
  4533. Stop scanning if we find something other than a comment or whitespace.
  4534. Set point to where scanning stops.
  4535. If N comments are found as expected, with nothing except whitespace
  4536. between them, return t; otherwise return nil.
  4537.  
  4538. arguments: (count)Fscan-lists
  4539. Scan from character number FROM by COUNT lists.
  4540. Returns the character number of the position thus found.
  4541.  
  4542. If DEPTH is nonzero, paren depth begins counting from that value,
  4543. only places where the depth in parentheses becomes zero
  4544. are candidates for stopping; COUNT such places are counted.
  4545. Thus, a positive value for DEPTH means go out levels.
  4546.  
  4547. Comments are ignored if `parse-sexp-ignore-comments' is non-nil.
  4548.  
  4549. If the beginning or end of (the accessible part of) the buffer is reached
  4550. and the depth is wrong, an error is signaled.
  4551. If the depth is right but the count is not used up, nil is returned.
  4552.  
  4553. arguments: (from count depth)Fscan-sexps
  4554. Scan from character number FROM by COUNT balanced expressions.
  4555. If COUNT is negative, scan backwards.
  4556. Returns the character number of the position thus found.
  4557.  
  4558. Comments are ignored if `parse-sexp-ignore-comments' is non-nil.
  4559.  
  4560. If the beginning or end of (the accessible part of) the buffer is reached
  4561. in the middle of a parenthetical grouping, an error is signaled.
  4562. If the beginning or end is reached between groupings
  4563. but before count is used up, nil is returned.
  4564.  
  4565. arguments: (from count)Fbackward-prefix-chars
  4566. Move point backward over any number of chars with prefix syntax.
  4567. This includes chars with "quote" or "prefix" syntax (' or p).
  4568.  
  4569. arguments: ()Fparse-partial-sexp
  4570. Parse Lisp syntax starting at FROM until TO; return status of parse at TO.
  4571. Parsing stops at TO or when certain criteria are met;
  4572.  point is set to where parsing stops.
  4573. If fifth arg STATE is omitted or nil,
  4574.  parsing assumes that FROM is the beginning of a function.
  4575. Value is a list of eight elements describing final state of parsing:
  4576.  0. depth in parens.
  4577.  1. character address of start of innermost containing list; nil if none.
  4578.  2. character address of start of last complete sexp terminated.
  4579.  3. non-nil if inside a string.
  4580.     (it is the character that will terminate the string.)
  4581.  4. t if inside a comment.
  4582.  5. t if following a quote character.
  4583.  6. the minimum paren-depth encountered during this scan.
  4584.  7. t if in a comment of style `b'.
  4585. If third arg TARGETDEPTH is non-nil, parsing stops if the depth
  4586. in parentheses becomes equal to TARGETDEPTH.
  4587. Fourth arg STOPBEFORE non-nil means stop when come to
  4588.  any character that starts a sexp.
  4589. Fifth arg STATE is an eight-list like what this function returns.
  4590. It is used to initialize the state of the parse.  Its second and third
  4591. elements are ignored.
  4592. Sixth args COMMENTSTOP non-nil means stop at the start of a comment.
  4593.  
  4594. arguments: (from to &optional targetdepth stopbefore state commentstop)Vparse-sexp-ignore-comments
  4595. Non-nil means `forward-sexp', etc., should treat comments as whitespace.Vwords-include-escapes
  4596. Non-nil means `forward-word', etc., should treat escape chars part of words.Fml-if
  4597. Mocklisp version of `if'.Fml-nargs
  4598. Number of arguments to currently executing mocklisp function.
  4599.  
  4600. arguments: ()Fml-arg
  4601. Argument number N to currently executing mocklisp function.
  4602.  
  4603. arguments: (n &optional prompt)Fml-interactive
  4604. True if currently executing mocklisp function was called interactively.
  4605.  
  4606. arguments: ()Fml-provide-prefix-argument
  4607. Evaluate second argument, using first argument as prefix arg value.Fml-prefix-argument-loop
  4608. Fml-substr
  4609. Return a substring of STRING, starting at index FROM and of length LENGTH.
  4610. If either FROM or LENGTH is negative, the length of STRING is added to it.
  4611.  
  4612. arguments: (string from to)Finsert-string
  4613. Mocklisp-compatibility insert function.
  4614. Like the function `insert' except that any argument that is a number
  4615. is converted into a string by expressing it in decimal.Fbyte-code
  4616. Function used internally in byte-compiled code.
  4617. The first argument is a string of byte code; the second, a vector of constants;
  4618. the third, the maximum stack depth used in this function.
  4619. If the third argument is incorrect, Emacs may crash.
  4620.  
  4621. arguments: (bytestr vector maxdepth)Vbyte-code-meter
  4622. A vector of vectors which holds a histogram of byte-code usage.
  4623. (aref (aref byte-code-meter 0) CODE) indicates how many times the byte
  4624. opcode CODE has been executed.
  4625. (aref (aref byte-code-meter CODE1) CODE2), where CODE1 is not 0,
  4626. indicates how many times the byte opcodes CODE1 and CODE2 have been
  4627. executed in succession.Vbyte-metering-on
  4628. If non-nil, keep profiling information on byte code usage.
  4629. The variable byte-code-meter indicates how often each byte opcode is used.
  4630. If a symbol has a property named `byte-code-meter' whose value is an
  4631. integer, it is incremented each time that symbol's function is called.Fprocessp
  4632. Return t if OBJECT is a process.
  4633.  
  4634. arguments: (obj)Fget-process
  4635. Return the process named NAME, or nil if there is none.
  4636.  
  4637. arguments: (name)Fget-buffer-process
  4638. Return the (or, a) process associated with BUFFER.
  4639. BUFFER may be a buffer or the name of one.
  4640.  
  4641. arguments: (name)Fdelete-process
  4642. Delete PROCESS: kill it and forget about it immediately.
  4643. PROCESS may be a process, a buffer, the name of a process or buffer, or
  4644. nil, indicating the current buffer's process.
  4645.  
  4646. arguments: (proc)Fprocess-status
  4647. Return the status of PROCESS: a symbol, one of these:
  4648. run  -- for a process that is running.
  4649. stop -- for a process stopped but continuable.
  4650. exit -- for a process that has exited.
  4651. signal -- for a process that has got a fatal signal.
  4652. open -- for a network stream connection that is open.
  4653. closed -- for a network stream connection that is closed.
  4654. nil -- if arg is a process name and no such process exists.
  4655. PROCESS may be a process, a buffer, the name of a process or buffer, or
  4656. nil, indicating the current buffer's process.
  4657.  
  4658. arguments: (proc)Fprocess-exit-status
  4659. Return the exit status of PROCESS or the signal number that killed it.
  4660. If PROCESS has not yet exited or died, return 0.
  4661.  
  4662. arguments: (proc)Fprocess-id
  4663. Return the process id of PROCESS.
  4664. This is the pid of the Unix process which PROCESS uses or talks to.
  4665. For a network connection, this value is nil.
  4666.  
  4667. arguments: (proc)Fprocess-name
  4668. Return the name of PROCESS, as a string.
  4669. This is the name of the program invoked in PROCESS,
  4670. possibly modified to make it unique among process names.
  4671.  
  4672. arguments: (proc)Fprocess-command
  4673. Return the command that was executed to start PROCESS.
  4674. This is a list of strings, the first string being the program executed
  4675. and the rest of the strings being the arguments given to it.
  4676. For a non-child channel, this is nil.
  4677.  
  4678. arguments: (proc)Fset-process-buffer
  4679. Set buffer associated with PROCESS to BUFFER (a buffer, or nil).
  4680.  
  4681. arguments: (proc buffer)Fprocess-buffer
  4682. Return the buffer PROCESS is associated with.
  4683. Output from PROCESS is inserted in this buffer
  4684. unless PROCESS has a filter.
  4685.  
  4686. arguments: (proc)Fprocess-mark
  4687. Return the marker for the end of the last output from PROCESS.
  4688.  
  4689. arguments: (proc)Fset-process-filter
  4690. Give PROCESS the filter function FILTER; nil means no filter.
  4691. t means stop accepting output from the process.
  4692. When a process has a filter, each time it does output
  4693. the entire string of output is passed to the filter.
  4694. The filter gets two arguments: the process and the string of output.
  4695. If the process has a filter, its buffer is not used for output.
  4696.  
  4697. arguments: (proc filter)Fprocess-filter
  4698. Returns the filter function of PROCESS; nil if none.
  4699. See `set-process-filter' for more info on filter functions.
  4700.  
  4701. arguments: (proc)Fset-process-sentinel
  4702. Give PROCESS the sentinel SENTINEL; nil for none.
  4703. The sentinel is called as a function when the process changes state.
  4704. It gets two arguments: the process, and a string describing the change.
  4705.  
  4706. arguments: (proc sentinel)Fprocess-sentinel
  4707. Return the sentinel of PROCESS; nil if none.
  4708. See `set-process-sentinel' for more info on sentinels.
  4709.  
  4710. arguments: (proc)Fprocess-kill-without-query
  4711. Say no query needed if PROCESS is running when Emacs is exited.
  4712. Optional second argument if non-nill says to require a query.
  4713. Value is t if a query was formerly required.
  4714.  
  4715. arguments: (proc &optional value)Fprocess-connection
  4716. Return the connection type of `PROCESS'.
  4717. The value is `nil' for a pipe,
  4718. `t' or `pty' for a pty, or `stream' for a socket connection.
  4719.  
  4720. arguments: (process)Flist-processes
  4721. Display a list of all processes.
  4722. (Any processes listed as Exited or Signaled are actually eliminated
  4723. after the listing is made.)
  4724.  
  4725. arguments: ()Fprocess-list
  4726. Return a list of all processes.
  4727.  
  4728. arguments: ()Fstart-process
  4729. Start a program in a subprocess.  Return the process object for it.
  4730. Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS
  4731. NAME is name for process.  It is modified if necessary to make it unique.
  4732. BUFFER is the buffer or (buffer-name) to associate with the process.
  4733.  Process output goes at end of that buffer, unless you specify
  4734.  an output stream or filter function to handle the output.
  4735.  BUFFER may be also nil, meaning that this process is not associated
  4736.  with any buffer
  4737. Third arg is program file name.  It is searched for as in the shell.
  4738. Remaining arguments are strings to give program as arguments.Fopen-network-stream
  4739. Open a TCP connection for a service to a host.
  4740. Returns a subprocess-object to represent the connection.
  4741. Input and output work as for subprocesses; `delete-process' closes it.
  4742. Args are NAME BUFFER HOST SERVICE.
  4743. NAME is name for process.  It is modified if necessary to make it unique.
  4744. BUFFER is the buffer (or buffer-name) to associate with the process.
  4745.  Process output goes at end of that buffer, unless you specify
  4746.  an output stream or filter function to handle the output.
  4747.  BUFFER may be also nil, meaning that this process is not associated
  4748.  with any buffer
  4749. Third arg is name of the host to connect to, or its IP address.
  4750. Fourth arg SERVICE is name of the service desired, or an integer
  4751.  specifying a port number to connect to.
  4752.  
  4753. arguments: (name buffer host service)Faccept-process-output
  4754. Allow any pending output from subprocesses to be read by Emacs.
  4755. It is read into the process' buffers or given to their filter functions.
  4756. Non-nil arg PROCESS means do not return until some output has been received
  4757. from PROCESS.
  4758. Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of
  4759. seconds and microseconds to wait; return after that much time whether
  4760. or not there is input.
  4761. Return non-nil iff we received any output before the timeout expired.
  4762.  
  4763. arguments: (&optional proc timeout timeout-msecs)Fwaiting-for-user-input-p
  4764. Returns non-NIL if emacs is waiting for input from the user.
  4765. This is intended for use by asynchronous process output filters and sentinels.
  4766.  
  4767. arguments: ()Fprocess-send-region
  4768. Send current contents of region as input to PROCESS.
  4769. PROCESS may be a process, a buffer, the name of a process or buffer, or
  4770. nil, indicating the current buffer's process.
  4771. Called from program, takes three arguments, PROCESS, START and END.
  4772. If the region is more than 500 characters long,
  4773. it is sent in several bunches.  This may happen even for shorter regions.
  4774. Output from processes can arrive in between bunches.
  4775.  
  4776. arguments: (process start end)Fprocess-send-string
  4777. Send PROCESS the contents of STRING as input.
  4778. PROCESS may be a process, a buffer, the name of a process or buffer, or
  4779. nil, indicating the current buffer's process.
  4780. If STRING is more than 500 characters long,
  4781. it is sent in several bunches.  This may happen even for shorter strings.
  4782. Output from processes can arrive in between bunches.
  4783.  
  4784. arguments: (process string)Finterrupt-process
  4785. Interrupt process PROCESS.  May be process or name of one.
  4786. PROCESS may be a process, a buffer, or the name of a process or buffer.
  4787. Nil or no arg means current buffer's process.
  4788. Second arg CURRENT-GROUP non-nil means send signal to
  4789. the current process-group of the process's controlling terminal
  4790. rather than to the process's own process group.
  4791. If the process is a shell, this means interrupt current subjob
  4792. rather than the shell.
  4793.  
  4794. arguments: (&optional process current-group)Fkill-process
  4795. Kill process PROCESS.  May be process or name of one.
  4796. See function `interrupt-process' for more details on usage.
  4797.  
  4798. arguments: (&optional process current-group)Fquit-process
  4799. Send QUIT signal to process PROCESS.  May be process or name of one.
  4800. See function `interrupt-process' for more details on usage.
  4801.  
  4802. arguments: (&optional process current-group)Fstop-process
  4803. Stop process PROCESS.  May be process or name of one.
  4804. See function `interrupt-process' for more details on usage.
  4805.  
  4806. arguments: (&optional process current-group)Fcontinue-process
  4807. Continue process PROCESS.  May be process or name of one.
  4808. See function `interrupt-process' for more details on usage.
  4809.  
  4810. arguments: (&optional process current-group)Fsignal-process
  4811. Send the process with number PID the signal with code CODE.
  4812. Both PID and CODE are integers.
  4813.  
  4814. arguments: (pid sig)Fprocess-send-eof
  4815. Make PROCESS see end-of-file in its input.
  4816. Eof comes after any text already sent to it.
  4817. PROCESS may be a process, a buffer, the name of a process or buffer, or
  4818. nil, indicating the current buffer's process.
  4819.  
  4820. arguments: (&optional process)Vdelete-exited-processes
  4821. *Non-nil means delete processes immediately when they exit.
  4822. nil means don't delete them until `list-processes' is run.Vprocess-connection-type
  4823. Control type of device used to communicate with subprocesses.
  4824. Values are nil to use a pipe, and t or 'pty for a pty.  Note that if
  4825. pty's are not available, this variable will be ignored. The value takes
  4826. effect when `start-process' is called.Fcall-process
  4827. Call PROGRAM synchronously in separate process.
  4828. The program's input comes from file INFILE (nil means `/dev/null').
  4829. Insert output in BUFFER before point; t means current buffer;
  4830.  nil for BUFFER means discard it; 0 means discard and don't wait.
  4831. Fourth arg DISPLAY non-nil means redisplay buffer as output is inserted.
  4832. Remaining arguments are strings passed as command arguments to PROGRAM.
  4833. If BUFFER is 0, returns immediately with value nil.
  4834. Otherwise waits for PROGRAM to terminate
  4835. and returns a numeric exit status or a signal description string.
  4836. If you quit, the process is killed with SIGINT, or SIGKILL if you quit again.Fcall-process-region
  4837. Send text from START to END to a synchronous process running PROGRAM.
  4838. Delete the text if fourth arg DELETE is non-nil.
  4839. Insert output in BUFFER before point; t means current buffer;
  4840.  nil for BUFFER means discard it; 0 means discard and don't wait.
  4841. Sixth arg DISPLAY non-nil means redisplay buffer as output is inserted.
  4842. Remaining args are passed to PROGRAM at startup as command args.
  4843. If BUFFER is nil, returns immediately with value nil.
  4844. Otherwise waits for PROGRAM to terminate
  4845. and returns a numeric exit status or a signal description string.
  4846. If you quit, the process is killed with SIGINT, or SIGKILL if you quit again.Fgetenv
  4847. Return the value of environment variable VAR, as a string.
  4848. VAR should be a string.  Value is nil if VAR is undefined in the environment.
  4849. This function consults the variable ``process-environment'' for its value.
  4850.  
  4851. arguments: (var)Vshell-file-name
  4852. *File name to load inferior shells from.
  4853. Initialized from the SHELL environment variable.Vexec-path
  4854. *List of directories to search programs to run in subprocesses.
  4855. Each element is a string (directory name) or nil (try default directory).Vexec-directory
  4856. Directory of architecture-dependent files that come with GNU Emacs,
  4857. especially executable programs intended for Emacs to invoke.Vdata-directory
  4858. Directory of architecture-independent files that come with GNU Emacs,
  4859. intended for Emacs to use.Vconfigure-info-directory
  4860. For internal use by the build procedure only.
  4861. This is the name of the directory in which the build procedure installed
  4862. Emacs's info files; the default value for Info-default-directory-list
  4863. includes this.Vprocess-environment
  4864. List of environment variables for subprocesses to inherit.
  4865. Each element should be a string of the form ENVVARNAME=VALUE.
  4866. The environment which Emacs inherits is placed in this variable
  4867. when Emacs starts.
  4868. Vonly-global-abbrevs
  4869. *t means user plans to use global abbrevs only.
  4870. Makes the commands to define mode-specific abbrevs define global ones instead.
  4871. Fabbrev-mode
  4872. Toggle abbrev mode.
  4873. With argument ARG, turn abbrev mode on iff ARG is positive.
  4874. In abbrev mode, inserting an abbreviation causes it to expand
  4875. and be replaced by its expansion.
  4876. Vedit-abbrevs-map
  4877. Keymap used in edit-abbrevs.
  4878. Fkill-all-abbrevs
  4879. Undefine all defined abbrevs.
  4880. Finsert-abbrevs
  4881. Insert after point a description of all defined abbrevs.
  4882. Mark is set after the inserted text.
  4883. Flist-abbrevs
  4884. Display a list of all defined abbrevs.
  4885. Fedit-abbrevs-mode
  4886. Major mode for editing the list of abbrev definitions.
  4887. \{edit-abbrevs-map}
  4888. Fedit-abbrevs
  4889. Alter abbrev definitions by editing a list of them.
  4890. Selects a buffer containing a list of abbrev definitions.
  4891. You can edit them and type \<edit-abbrevs-map>\[edit-abbrevs-redefine] to redefine abbrevs
  4892. according to your editing.
  4893. Buffer contains a header line for each abbrev table,
  4894.  which is the abbrev table name in parentheses.
  4895. This is followed by one line per abbrev in that table:
  4896. NAME   USECOUNT   EXPANSION   HOOK
  4897. where NAME and EXPANSION are strings with quotes,
  4898. USECOUNT is an integer, and HOOK is any valid function
  4899. or may be omitted (it is usually omitted).
  4900. Fedit-abbrevs-redefine
  4901. Redefine abbrevs according to current buffer contents.
  4902. Fdefine-abbrevs
  4903. Define abbrevs according to current visible buffer contents.
  4904. See documentation of `edit-abbrevs' for info on the format of the
  4905. text you must have in the buffer.
  4906. With argument, eliminate all abbrev definitions except
  4907. the ones defined from the buffer now.
  4908. Fread-abbrev-file
  4909. Read abbrev definitions from file written with `write-abbrev-file'.
  4910. Optional argument FILE is the name of the file to read;
  4911. it defaults to the value of `abbrev-file-name'.
  4912. Optional second argument QUIETLY non-nil means don't print anything.
  4913. Fquietly-read-abbrev-file
  4914. Read abbrev definitions from file written with write-abbrev-file.
  4915. Optional argument FILE is the name of the file to read;
  4916. it defaults to the value of `abbrev-file-name'.
  4917. Does not print anything.
  4918. Fwrite-abbrev-file
  4919. Write all abbrev definitions to a file of Lisp code.
  4920. The file written can be loaded in another session to define the same abbrevs.
  4921. The argument FILE is the file name to write.
  4922. Fadd-mode-abbrev
  4923. Define mode-specific abbrev for last word(s) before point.
  4924. Argument is how many words before point form the expansion;
  4925. or zero means the region is the expansion.
  4926. A negative argument means to undefine the specified abbrev.
  4927. Reads the abbreviation in the minibuffer.
  4928.  
  4929. Don't use this function in a Lisp program; use `define-abbrev' instead.
  4930. Fadd-global-abbrev
  4931. Define global (all modes) abbrev for last word(s) before point.
  4932. The prefix argument specifies the number of words before point that form the
  4933. expansion; or zero means the region is the expansion.
  4934. A negative argument means to undefine the specified abbrev.
  4935. This command uses the minibuffer to read the abbreviation.
  4936.  
  4937. Don't use this function in a Lisp program; use `define-abbrev' instead.
  4938. Finverse-add-mode-abbrev
  4939. Define last word before point as a mode-specific abbrev.
  4940. With prefix argument N, defines the Nth word before point.
  4941. This command uses the minibuffer to read the expansion.
  4942. Expands the abbreviation after defining it.
  4943. Finverse-add-global-abbrev
  4944. Define last word before point as a global (mode-independent) abbrev.
  4945. With prefix argument N, defines the Nth word before point.
  4946. This command uses the minibuffer to read the expansion.
  4947. Expands the abbreviation after defining it.
  4948. Fabbrev-prefix-mark
  4949. Mark current point as the beginning of an abbrev.
  4950. Abbrev to be expanded starts here rather than at beginning of word.
  4951. This way, you can expand an abbrev with a prefix: insert the prefix,
  4952. use this command, then insert the abbrev.
  4953. Fexpand-region-abbrevs
  4954. For abbrev occurrence in the region, offer to expand it.
  4955. The user is asked to type y or n for each occurrence.
  4956. A prefix argument means don't query; expand all abbrevs.
  4957. If called from a Lisp program, arguments are START END &optional NOQUERY.
  4958. VBuffer-menu-mode-map
  4959.  
  4960. FBuffer-menu-mode
  4961. Major mode for editing a list of buffers.
  4962. Each line describes one of the buffers in Emacs.
  4963. Letters do not insert themselves; instead, they are commands.
  4964. \<Buffer-menu-mode-map>
  4965. \[Buffer-menu-mark] -- mark buffer to be displayed.
  4966. \[Buffer-menu-select] -- select buffer of line point is on.
  4967.   Also show buffers marked with m in other windows.
  4968. \[Buffer-menu-1-window] -- select that buffer in full-frame window.
  4969. \[Buffer-menu-2-window] -- select that buffer in one window,
  4970.   together with buffer selected before this one in another window.
  4971. \[Buffer-menu-this-window] -- select that buffer in place of the buffer menu buffer.
  4972. \[Buffer-menu-other-window] -- select that buffer in another window,
  4973.   so the buffer menu buffer remains visible in its window.
  4974. \[Buffer-menu-switch-other-window] -- switch the other window to this buffer.
  4975. \[Buffer-menu-visit-tags-table] -- visit-tags-table this buffer.
  4976. \[Buffer-menu-not-modified] -- clear modified-flag on that buffer.
  4977. \[Buffer-menu-save] -- mark that buffer to be saved, and move down.
  4978. \[Buffer-menu-delete] -- mark that buffer to be deleted, and move down.
  4979. \[Buffer-menu-delete-backwards] -- mark that buffer to be deleted, and move up.
  4980. \[Buffer-menu-execute] -- delete or save marked buffers.
  4981. \[Buffer-menu-unmark] -- remove all kinds of marks from current line.
  4982.   With prefix argument, also move up one line.
  4983. \[Buffer-menu-backup-unmark] -- back up a line and remove marks.
  4984. \[Buffer-menu-toggle-read-only] -- toggle read-only status of buffer on this line.
  4985. FBuffer-menu-buffer
  4986. Return buffer described by this line of buffer menu.
  4987. Fbuffer-menu
  4988. Make a menu of buffers so you can save, delete or select them.
  4989. With argument, show only buffers that are visiting files.
  4990. Type ? after invocation to get help on commands available.
  4991. Type q immediately to make the buffer menu go away and to restore
  4992. previous window configuration.
  4993. FBuffer-menu-quit
  4994. Quit the buffer menu.
  4995. FBuffer-menu-mark
  4996. Mark buffer on this line for being displayed by \<Buffer-menu-mode-map>\[Buffer-menu-select] command.
  4997. FBuffer-menu-unmark
  4998. Cancel all requested operations on buffer on this line and move down.
  4999. Optional ARG means move up.
  5000. FBuffer-menu-backup-unmark
  5001. Move up and cancel all requested operations on buffer on line above.
  5002. FBuffer-menu-delete
  5003. Mark buffer on this line to be deleted by \<Buffer-menu-mode-map>\[Buffer-menu-execute] command.
  5004. FBuffer-menu-delete-backwards
  5005. Mark buffer on this line to be deleted by \<Buffer-menu-mode-map>\[Buffer-menu-execute] command
  5006. and then move up one line
  5007. FBuffer-menu-save
  5008. Mark buffer on this line to be saved by \<Buffer-menu-mode-map>\[Buffer-menu-execute] command.
  5009. FBuffer-menu-not-modified
  5010. Mark buffer on this line as unmodified (no changes to save).
  5011. FBuffer-menu-execute
  5012. Save and/or delete buffers marked with \<Buffer-menu-mode-map>\[Buffer-menu-save] or \<Buffer-menu-mode-map>\[Buffer-menu-delete] commands.
  5013. FBuffer-menu-select
  5014. Select this line's buffer; also display buffers marked with `>'.
  5015. You can mark buffers with the \<Buffer-menu-mode-map>\[Buffer-menu-mark] command.
  5016. FBuffer-menu-visit-tags-table
  5017. Visit the tags table in the buffer on this line.  See `visit-tags-table'.
  5018. FBuffer-menu-1-window
  5019. Select this line's buffer, alone, in full frame.
  5020. FBuffer-menu-this-window
  5021. Select this line's buffer in this window.
  5022. FBuffer-menu-other-window
  5023. Select this line's buffer in other window, leaving buffer menu visible.
  5024. FBuffer-menu-switch-other-window
  5025. Make the other window select this line's buffer.
  5026. The current window remains selected.
  5027. FBuffer-menu-2-window
  5028. Select this line's buffer, with previous buffer in second window.
  5029. FBuffer-menu-toggle-read-only
  5030. Toggle read-only status of buffer on this line.
  5031. Fdefsubst
  5032. Define an inline function.  The syntax is just like that of `defun'.
  5033. Fmake-obsolete
  5034. Make the byte-compiler warn that FUNCTION is obsolete.
  5035. The warning will say that NEW should be used instead.
  5036. If NEW is a string, that is the `use instead' message.
  5037. Fmake-obsolete-variable
  5038. Make the byte-compiler warn that VARIABLE is obsolete,
  5039. and NEW should be used instead.  If NEW is a string, then that is the
  5040. `use instead' message.
  5041. Fdont-compile
  5042. Like `progn', but the body always runs interpreted (not compiled).
  5043. If you think you need this, you're probably making a mistake somewhere.
  5044. Feval-when-compile
  5045. Like `progn', but evaluates the body at compile time.
  5046. The result of the body appears to the compiler as a quoted constant.
  5047. Feval-and-compile
  5048. Like `progn', but evaluates the body at compile time and at load time.
  5049. Vc-mode-abbrev-table
  5050. Abbrev table in use in C mode.
  5051. Vc-mode-map
  5052. Keymap used in C mode.
  5053. Fc-macro-expand
  5054. Display the result of expanding all C macros occurring in the region.
  5055. The expansion is entirely correct because it uses the C preprocessor.
  5056. Vc-mode-syntax-table
  5057. Syntax table in use in C-mode buffers.
  5058. Vc-indent-level
  5059. *Indentation of C statements with respect to containing block.
  5060. Vc-brace-imaginary-offset
  5061. *Imagined indentation of a C open brace that actually follows a statement.
  5062. Vc-brace-offset
  5063. *Extra indentation for braces, compared with other text in same context.
  5064. Vc-argdecl-indent
  5065. *Indentation level of declarations of C function arguments.
  5066. Vc-label-offset
  5067. *Offset of C label lines and case statements relative to usual indentation.
  5068. Vc-continued-statement-offset
  5069. *Extra indent for lines not starting new statements.
  5070. Vc-continued-brace-offset
  5071. *Extra indent for substatements that start with open-braces.
  5072. This is in addition to c-continued-statement-offset.
  5073. Vc-auto-newline
  5074. *Non-nil means automatically newline before and after braces,
  5075. and after colons and semicolons, inserted in C code.
  5076. If you do not want a leading newline before braces then use:
  5077.   (define-key c-mode-map "{" 'electric-c-semi)
  5078. Vc-tab-always-indent
  5079. *Non-nil means TAB in C mode should always reindent the current line,
  5080. regardless of where in the line point is when the TAB command is used.
  5081. Fc-mode
  5082. Major mode for editing C code.
  5083. Expression and list commands understand all C brackets.
  5084. Tab indents for C code.
  5085. Comments are delimited with /* ... */.
  5086. Paragraphs are separated by blank lines only.
  5087. Delete converts tabs to spaces as it moves back.
  5088. \{c-mode-map}
  5089. Variables controlling indentation style:
  5090.  c-tab-always-indent
  5091.     Non-nil means TAB in C mode should always reindent the current line,
  5092.     regardless of where in the line point is when the TAB command is used.
  5093.  c-auto-newline
  5094.     Non-nil means automatically newline before and after braces,
  5095.     and after colons and semicolons, inserted in C code.
  5096.  c-indent-level
  5097.     Indentation of C statements within surrounding block.
  5098.     The surrounding block's indentation is the indentation
  5099.     of the line on which the open-brace appears.
  5100.  c-continued-statement-offset
  5101.     Extra indentation given to a substatement, such as the
  5102.     then-clause of an if or body of a while.
  5103.  c-continued-brace-offset
  5104.     Extra indentation given to a brace that starts a substatement.
  5105.     This is in addition to c-continued-statement-offset.
  5106.  c-brace-offset
  5107.     Extra indentation for line if it starts with an open brace.
  5108.  c-brace-imaginary-offset
  5109.     An open brace following other text is treated as if it were
  5110.     this far to the right of the start of its line.
  5111.  c-argdecl-indent
  5112.     Indentation level of declarations of C function arguments.
  5113.  c-label-offset
  5114.     Extra indentation for line that is a label, or case or default.
  5115.  
  5116. Settings for K&R and BSD indentation styles are
  5117.   c-indent-level                5    8
  5118.   c-continued-statement-offset  5    8
  5119.   c-brace-offset               -5   -8
  5120.   c-argdecl-indent              0    8
  5121.   c-label-offset               -5   -8
  5122.  
  5123. Turning on C mode calls the value of the variable c-mode-hook with no args,
  5124. if that value is non-nil.
  5125. Fc-fill-paragraph
  5126. Like \[fill-paragraph] but handle C comments.
  5127. If any of the current line is a comment or within a comment,
  5128. fill the comment or the paragraph of it that point is in,
  5129. preserving the comment indentation or line-starting decorations.
  5130. Felectric-c-brace
  5131. Insert character and correct line's indentation.
  5132. Felectric-c-sharp-sign
  5133. Insert character and correct line's indentation.
  5134. Felectric-c-semi
  5135. Insert character and correct line's indentation.
  5136. Felectric-c-terminator
  5137. Insert character and correct line's indentation.
  5138. Fc-indent-command
  5139. Indent current line as C code, or in some cases insert a tab character.
  5140. If `c-tab-always-indent' is non-nil (the default), always indent current line.
  5141. Otherwise, indent the current line only if point is at the left margin or
  5142. in the line's indentation; otherwise insert a tab.
  5143.  
  5144. A numeric argument, regardless of its value, means indent rigidly all the
  5145. lines of the expression starting after point so that this line becomes
  5146. properly indented.  The relative indentation among the lines of the
  5147. expression are preserved.
  5148. Fc-indent-line
  5149. Indent current line as C code.
  5150. Return the amount the indentation changed by.
  5151. Fcalculate-c-indent
  5152. Return appropriate indentation for current line as C code.
  5153. In usual case returns an integer: the column to indent to.
  5154. Returns nil if line starts inside a string, t if in a comment.
  5155. Fcalculate-c-indent-within-comment
  5156. Return the indentation amount for line inside a block comment.
  5157. Optional arg AFTER-STAR means, if lines in the comment have a leading star,
  5158. return the indentation of the text that would follow this star.
  5159. Fc-backward-to-start-of-if
  5160. Move to the start of the last "unbalanced" `if'.
  5161. Fc-backward-to-start-of-do
  5162. If point follows a `do' statement, move to beginning of it and return t.
  5163. Otherwise return nil and don't move point.
  5164. Fc-beginning-of-statement
  5165. Go to the beginning of the innermost C statement.
  5166. With prefix arg, go back N - 1 statements.  If already at the beginning of a
  5167. statement then go to the beginning of the preceding one.
  5168. If within a string or comment, or next to a comment (only whitespace between),
  5169. move by sentences instead of statements.
  5170. Fc-end-of-statement
  5171. Go to the end of the innermost C statement.
  5172. With prefix arg, go forward N - 1 statements.
  5173. Move forward to end of the next statement if already at end.
  5174. If within a string or comment, move by sentences instead of statements.
  5175. Fmark-c-function
  5176. Put mark at end of C function, point at beginning.
  5177. Findent-c-exp
  5178. Indent each line of the C grouping following point.
  5179. Fset-c-style
  5180. Set C-mode variables to use one of several different indentation styles.
  5181. The arguments are a string representing the desired style
  5182. and a flag which, if non-nil, means to set the style globally.
  5183. (Interactively, the flag comes from the prefix argument.)
  5184. Available styles are GNU, K&R, BSD and Whitesmith.
  5185. Vc-backslash-column
  5186. *Minimum column for end-of-line backslashes of macro definitions.
  5187. Fc-backslash-region
  5188. Insert, align, or delete end-of-line backslashes on the lines in the region.
  5189. With no argument, inserts backslashes and aligns existing backslashes.
  5190. With an argument, deletes the backslashes.
  5191.  
  5192. This function does not modify the last line of the region if the region ends 
  5193. right at the start of the following line; it does not modify blank lines
  5194. at the start of the region.  So you can put the region around an entire macro
  5195. definition and conveniently use this command.
  5196. Fc-up-conditional
  5197. Move back to the containing preprocessor conditional, leaving mark behind.
  5198. A prefix argument acts as a repeat count.  With a negative argument,
  5199. move forward to the end of the containing preprocessor conditional.
  5200. When going backwards, `#elif' is treated like `#else' followed by `#if'.
  5201. When going forwards, `#elif' is ignored.
  5202. Fc-backward-conditional
  5203. Move back across a preprocessor conditional, leaving mark behind.
  5204. A prefix argument acts as a repeat count.  With a negative argument,
  5205. move forward across a preprocessor conditional.
  5206. Fc-forward-conditional
  5207. Move forward across a preprocessor conditional, leaving mark behind.
  5208. A prefix argument acts as a repeat count.  With a negative argument,
  5209. move backward across a preprocessor conditional.
  5210. Vdelete-auto-save-files
  5211. *Non-nil means delete a buffer's auto-save file when the buffer is saved.
  5212. Vdirectory-abbrev-alist
  5213. *Alist of abbreviations for file directories.
  5214. A list of elements of the form (FROM . TO), each meaning to replace
  5215. FROM with TO when it appears in a directory name.  This replacement is
  5216. done when setting up the default directory of a newly visited file.
  5217. *Every* FROM string should start with `^'.
  5218.  
  5219. Do not use `~' in the TO strings.
  5220. They should be ordinary absolute directory names.
  5221.  
  5222. Use this feature when you have directories which you normally refer to
  5223. via absolute symbolic links.  Make TO the name of the link, and FROM
  5224. the name it is linked to.
  5225. Vmake-backup-files
  5226. *Non-nil means make a backup of a file the first time it is saved.
  5227. This can be done by renaming the file or by copying.
  5228.  
  5229. Renaming means that Emacs renames the existing file so that it is a
  5230. backup file, then writes the buffer into a new file.  Any other names
  5231. that the old file had will now refer to the backup file.  The new file
  5232. is owned by you and its group is defaulted.
  5233.  
  5234. Copying means that Emacs copies the existing file into the backup
  5235. file, then writes the buffer on top of the existing file.  Any other
  5236. names that the old file had will now refer to the new (edited) file.
  5237. The file's owner and group are unchanged.
  5238.  
  5239. The choice of renaming or copying is controlled by the variables
  5240. `backup-by-copying', `backup-by-copying-when-linked' and
  5241. `backup-by-copying-when-mismatch'.  See also `backup-inhibited'.
  5242. Vbackup-inhibited
  5243. Non-nil means don't make a backup, regardless of the other parameters.
  5244. This variable is intended for use by making it local to a buffer.
  5245. But it is local only if you make it local.
  5246. Vbackup-by-copying
  5247. *Non-nil means always use copying to create backup files.
  5248. See documentation of variable `make-backup-files'.
  5249. Vbackup-by-copying-when-linked
  5250. *Non-nil means use copying to create backups for files with multiple names.
  5251. This causes the alternate names to refer to the latest version as edited.
  5252. This variable is relevant only if `backup-by-copying' is nil.
  5253. Vbackup-by-copying-when-mismatch
  5254. *Non-nil means create backups by copying if this preserves owner or group.
  5255. Renaming may still be used (subject to control of other variables)
  5256. when it would not result in changing the owner or group of the file;
  5257. that is, for files which are owned by you and whose group matches
  5258. the default for a new file created there by you.
  5259. This variable is relevant only if `backup-by-copying' is nil.
  5260. Vbackup-enable-predicate
  5261. Predicate that looks at a file name and decides whether to make backups.
  5262. Called with an absolute file name as argument, it returns t to enable backup.
  5263. Vbuffer-offer-save
  5264. *Non-nil in a buffer means offer to save the buffer on exit
  5265. even if the buffer is not visiting a file.
  5266. Automatically local in all buffers.
  5267. Vfind-file-existing-other-name
  5268. *Non-nil means find a file under alternative names, in existing buffers.
  5269. This means if any existing buffer is visiting the file you want
  5270. under another name, you get the existing buffer instead of a new buffer.
  5271. Vfind-file-visit-truename
  5272. *Non-nil means visit a file under its truename.
  5273. The truename of a file is found by chasing all links
  5274. both at the file level and at the levels of the containing directories.
  5275. Vbuffer-file-truename
  5276. The truename of the file visited in the current buffer.
  5277. This variable is automatically local in all buffers, when non-nil.
  5278. Vbuffer-file-number
  5279. The device number and file number of the file visited in the current buffer.
  5280. The value is a list of the form (FILENUM DEVNUM).
  5281. This pair of numbers uniquely identifies the file.
  5282. If the buffer is visiting a new file, the value is nil.
  5283. Vfile-precious-flag
  5284. *Non-nil means protect against I/O errors while saving files.
  5285. Some modes set this non-nil in particular buffers.
  5286. Vversion-control
  5287. *Control use of version numbers for backup files.
  5288. t means make numeric backup versions unconditionally.
  5289. nil means make them for files that have some already.
  5290. never means do not make them.
  5291. Vdired-kept-versions
  5292. *When cleaning directory, number of versions to keep.
  5293. Vtrim-versions-without-asking
  5294. *If t, deletes excess backup versions silently.
  5295. If nil, asks confirmation.  Any other value prevents any trimming.
  5296. Vkept-old-versions
  5297. *Number of oldest versions to keep when a new numbered backup is made.
  5298. Vkept-new-versions
  5299. *Number of newest versions to keep when a new numbered backup is made.
  5300. Includes the new backup.  Must be > 0
  5301. Vrequire-final-newline
  5302. *Value of t says silently ensure a file ends in a newline when it is saved.
  5303. Non-nil but not t says ask user whether to add a newline when there isn't one.
  5304. nil means don't add newlines.
  5305. Vauto-save-default
  5306. *Non-nil says by default do auto-saving of every file-visiting buffer.
  5307. Vauto-save-visited-file-name
  5308. *Non-nil says auto-save a buffer in the file it is visiting, when practical.
  5309. Normally auto-save files are written under other names.
  5310. Vsave-abbrevs
  5311. *Non-nil means save word abbrevs too when files are saved.
  5312. Loading an abbrev file sets this to t.
  5313. Vfind-file-run-dired
  5314. *Non-nil says run dired if `find-file' is given the name of a directory.
  5315. Vfind-file-not-found-hooks
  5316. List of functions to be called for `find-file' on nonexistent file.
  5317. These functions are called as soon as the error is detected.
  5318. `buffer-file-name' is already set up.
  5319. The functions are called in the order given until one of them returns non-nil.
  5320. Vfind-file-hooks
  5321. List of functions to be called after a buffer is loaded from a file.
  5322. The buffer's local variables (if any) will have been processed before the
  5323. functions are called.
  5324. Vwrite-file-hooks
  5325. List of functions to be called before writing out a buffer to a file.
  5326. If one of them returns non-nil, the file is considered already written
  5327. and the rest are not called.
  5328. These hooks are considered to pertain to the visited file.
  5329. So this list is cleared if you change the visited file name.
  5330. See also `write-contents-hooks'.
  5331. Don't make this variable buffer-local; instead, use `local-write-file-hooks'.
  5332. Vlocal-write-file-hooks
  5333. Just like `write-file-hooks', except intended for per-buffer use.
  5334. The functions in this list are called before the ones in
  5335. `write-file-hooks'.
  5336. Vwrite-contents-hooks
  5337. List of functions to be called before writing out a buffer to a file.
  5338. If one of them returns non-nil, the file is considered already written
  5339. and the rest are not called.
  5340. These hooks are considered to pertain to the buffer's contents,
  5341. not to the particular visited file; thus, `set-visited-file-name' does
  5342. not clear this variable, but changing the major mode does clear it.
  5343. See also `write-file-hooks'.
  5344. Venable-local-variables
  5345. *Control use of local-variables lists in files you visit.
  5346. The value can be t, nil or something else.
  5347. A value of t means local-variables lists are obeyed;
  5348. nil means they are ignored; anything else means query.
  5349.  
  5350. The command \[normal-mode] always obeys local-variables lists
  5351. and ignores this variable.
  5352. Venable-local-eval
  5353. *Control processing of the "variable" `eval' in a file's local variables.
  5354. The value can be t, nil or something else.
  5355. A value of t means obey `eval' variables;
  5356. nil means ignore them; anything else means query.
  5357.  
  5358. The command \[normal-mode] always obeys local-variables lists
  5359. and ignores this variable.
  5360. Fpwd
  5361. Show the current default directory.
  5362. Vcd-path
  5363. Value of the CDPATH environment variable, as a list.
  5364. Not actually set up until the first time you you use it.
  5365. Fparse-colon-path
  5366. Explode a colon-separated list of paths into a string list.
  5367. Fcd-absolute
  5368. Change current directory to given absolute file name DIR.
  5369. Fcd
  5370. Make DIR become the current buffer's default directory.
  5371. If your environment includes a `CDPATH' variable, try each one of that
  5372. colon-separated list of directories when resolving a relative directory name.
  5373. Fload-file
  5374. Load the Lisp file named FILE.
  5375. Fload-library
  5376. Load the library named LIBRARY.
  5377. This is an interface to the function `load'.
  5378. Ffile-local-copy
  5379. Copy the file FILE into a temporary file on this machine.
  5380. Returns the name of the local copy, or nil, if FILE is directly
  5381. accessible.
  5382. Ffile-truename
  5383. Return the truename of FILENAME, which should be absolute.
  5384. The truename of a file name is found by chasing symbolic links
  5385. both at the level of the file and at the level of the directories
  5386. containing it, until no links are left at any level.
  5387. Ffile-chase-links
  5388. Chase links in FILENAME until a name that is not a link.
  5389. Does not examine containing directories for links,
  5390. unlike `file-truename'.
  5391. Fswitch-to-buffer-other-window
  5392. Select buffer BUFFER in another window.
  5393. Fswitch-to-buffer-other-frame
  5394. Switch to buffer BUFFER in another frame.
  5395. Ffind-file
  5396. Edit file FILENAME.
  5397. Switch to a buffer visiting file FILENAME,
  5398. creating one if none already exists.
  5399. Ffind-file-other-window
  5400. Edit file FILENAME, in another window.
  5401. May create a new window, or reuse an existing one.
  5402. See the function `display-buffer'.
  5403. Ffind-file-other-frame
  5404. Edit file FILENAME, in another frame.
  5405. May create a new frame, or reuse an existing one.
  5406. See the function `display-buffer'.
  5407. Ffind-file-read-only
  5408. Edit file FILENAME but don't allow changes.
  5409. Like \[find-file] but marks buffer as read-only.
  5410. Use \[toggle-read-only] to permit editing.
  5411. Ffind-file-read-only-other-window
  5412. Edit file FILENAME in another window but don't allow changes.
  5413. Like \[find-file-other-window] but marks buffer as read-only.
  5414. Use \[toggle-read-only] to permit editing.
  5415. Ffind-file-read-only-other-frame
  5416. Edit file FILENAME in another frame but don't allow changes.
  5417. Like \[find-file-other-frame] but marks buffer as read-only.
  5418. Use \[toggle-read-only] to permit editing.
  5419. Ffind-alternate-file
  5420. Find file FILENAME, select its buffer, kill previous buffer.
  5421. If the current buffer now contains an empty file that you just visited
  5422. (presumably by mistake), use this command to visit the file you really want.
  5423. Fcreate-file-buffer
  5424. Create a suitably named buffer for visiting FILENAME, and return it.
  5425. FILENAME (sans directory) is used unchanged if that name is free;
  5426. otherwise a string <2> or <3> or ... is appended to get an unused name.
  5427. Fgenerate-new-buffer
  5428. Create and return a buffer with a name based on NAME.
  5429. Choose the buffer's name using `generate-new-buffer-name'.
  5430. Vautomount-dir-prefix
  5431. Regexp to match the automounter prefix in a directory name.
  5432. Vabbreviated-home-dir
  5433. The user's homedir abbreviated according to `directory-abbrev-list'.
  5434. Fabbreviate-file-name
  5435. Return a version of FILENAME shortened using `directory-abbrev-alist'.
  5436. This also substitutes "~" for the user's home directory.
  5437. Type \[describe-variable] directory-abbrev-alist RET for more information.
  5438. Vfind-file-not-true-dirname-list
  5439. *List of logical names for which visiting shouldn't save the true dirname.
  5440. On VMS, when you visit a file using a logical name that searches a path,
  5441. you may or may not want the visited file name to record the specific
  5442. directory where the file was found.  If you *do not* want that, add the logical
  5443. name to this list as a string.
  5444. Ffind-file-noselect
  5445. Read file FILENAME into a buffer and return the buffer.
  5446. If a buffer exists visiting FILENAME, return that one, but
  5447. verify that the file has not changed since visited or saved.
  5448. The buffer is not selected, just returned to the caller.
  5449. Fafter-find-file
  5450. Called after finding a file and by the default revert function.
  5451. Sets buffer mode, parses local variables.
  5452. Optional args ERROR, WARN, and NOAUTO: ERROR non-nil means there was an
  5453. error in reading the file.  WARN non-nil means warn if there
  5454. exists an auto-save file more recent than the visited file.
  5455. NOAUTO means don't mess with auto-save mode.
  5456. Finishes by calling the functions in `find-file-hooks'.
  5457. Fnormal-mode
  5458. Choose the major mode for this buffer automatically.
  5459. Also sets up any specified local variables of the file.
  5460. Uses the visited file name, the -*- line, and the local variables spec.
  5461.  
  5462. This function is called automatically from `find-file'.  In that case,
  5463. we may set up specified local variables depending on the value of
  5464. `enable-local-variables': if it is t, we do; if it is nil, we don't;
  5465. otherwise, we query.  `enable-local-variables' is ignored if you
  5466. run `normal-mode' explicitly.
  5467. Vauto-mode-alist
  5468. Alist of filename patterns vs corresponding major mode functions.
  5469. Each element looks like (REGEXP . FUNCTION).
  5470. Visiting a file whose name matches REGEXP causes FUNCTION to be called.
  5471. Vinhibit-local-variables-regexps
  5472. List of regexps; if one matches a file name, don't look for local vars.
  5473. Fset-auto-mode
  5474. Select major mode appropriate for current buffer.
  5475. This checks for a -*- mode tag in the buffer's text, or
  5476. compares the filename against the entries in auto-mode-alist.  It does
  5477. not check for the "mode:" local variable in the Local Variables
  5478. section of the file; for that, use `hack-local-variables'.
  5479.  
  5480. If `enable-local-variables' is nil, this function does not check for a
  5481. -*- mode tag.
  5482. Fhack-local-variables
  5483. Parse and put into effect this buffer's local variables spec.
  5484. Vignored-local-variables
  5485. Variables to be ignored in a file's local variable spec.
  5486. Fset-visited-file-name
  5487. Change name of file visited in current buffer to FILENAME.
  5488. The next time the buffer is saved it will go in the newly specified file.
  5489. nil or empty string as argument means make buffer not be visiting any file.
  5490. Remember to delete the initial contents of the minibuffer
  5491. if you wish to pass an empty string as the argument.
  5492. Fwrite-file
  5493. Write current buffer into file FILENAME.
  5494. Makes buffer visit that file, and marks it not modified.
  5495. If the buffer is already visiting a file, you can specify
  5496. a directory name as FILENAME, to write a file of the same
  5497. old name in that directory.
  5498. Fbackup-buffer
  5499. Make a backup of the disk file visited by the current buffer, if appropriate.
  5500. This is normally done before saving the buffer the first time.
  5501. If the value is non-nil, it is the result of `file-modes' on the original
  5502. file; this means that the caller, after saving the buffer, should change
  5503. the modes of the new file to agree with the old modes.
  5504. Ffile-name-sans-versions
  5505. Return FILENAME sans backup versions or strings.
  5506. This is a separate procedure so your site-init or startup file can
  5507. redefine it.
  5508. If the optional argument KEEP-BACKUP-VERSION is non-nil,
  5509. we do not remove backup version numbers, only true file version numbers.
  5510. Fmake-backup-file-name
  5511. Create the non-numeric backup file name for FILE.
  5512. This is a separate function so you can redefine it for customization.
  5513. Fbackup-file-name-p
  5514. Return non-nil if FILE is a backup file name (numeric or not).
  5515. This is a separate function so you can redefine it for customization.
  5516. You may need to redefine `file-name-sans-versions' as well.
  5517. Fbackup-extract-version
  5518. Given the name of a numeric backup file, return the backup number.
  5519. Uses the free variable `bv-length', whose value should be
  5520. the index in the name where the version number begins.
  5521. Ffind-backup-file-name
  5522. Find a file name for a backup file, and suggestions for deletions.
  5523. Value is a list whose car is the name for the backup file
  5524.  and whose cdr is a list of old versions to consider deleting now.
  5525. Ffile-nlinks
  5526. Return number of names file FILENAME has.
  5527. Ffile-relative-name
  5528. Convert FILENAME to be relative to DIRECTORY (default: default-directory).
  5529. Fsave-buffer
  5530. Save current buffer in visited file if modified.  Versions described below.
  5531. By default, makes the previous version into a backup file
  5532.  if previously requested or if this is the first save.
  5533. With 1 or 3 \[universal-argument]'s, marks this version
  5534.  to become a backup when the next save is done.
  5535. With 2 or 3 \[universal-argument]'s,
  5536.  unconditionally makes the previous version into a backup file.
  5537. With argument of 0, never makes the previous version into a backup file.
  5538.  
  5539. If a file's name is FOO, the names of its numbered backup versions are
  5540.  FOO.~i~ for various integers i.  A non-numbered backup file is called FOO~.
  5541. Numeric backups (rather than FOO~) will be made if value of
  5542.  `version-control' is not the atom `never' and either there are already
  5543.  numeric versions of the file being backed up, or `version-control' is
  5544.  non-nil.
  5545. We don't want excessive versions piling up, so there are variables
  5546.  `kept-old-versions', which tells Emacs how many oldest versions to keep,
  5547.  and `kept-new-versions', which tells how many newest versions to keep.
  5548.  Defaults are 2 old versions and 2 new.
  5549. `dired-kept-versions' controls dired's clean-directory (.) command.
  5550. If `trim-versions-without-asking' is nil, system will query user
  5551.  before trimming versions.  Otherwise it does it silently.
  5552. Fdelete-auto-save-file-if-necessary
  5553. Delete auto-save file for current buffer if `delete-auto-save-files' is t.
  5554. Normally delete only if the file was written by this Emacs since
  5555. the last real save, but optional arg FORCE non-nil means delete anyway.
  5556. Fbasic-save-buffer
  5557. Save the current buffer in its visited file, if it has been modified.
  5558. Fsave-some-buffers
  5559. Save some modified file-visiting buffers.  Asks user about each one.
  5560. Optional argument (the prefix) non-nil means save all with no questions.
  5561. Optional second argument EXITING means ask about certain non-file buffers
  5562.  as well as about file buffers.
  5563. Fnot-modified
  5564. Mark current buffer as unmodified, not needing to be saved.
  5565. With prefix arg, mark buffer as modified, so \[save-buffer] will save.
  5566. Ftoggle-read-only
  5567. Change whether this buffer is visiting its file read-only.
  5568. With arg, set read-only iff arg is positive.
  5569. Finsert-file
  5570. Insert contents of file FILENAME into buffer after point.
  5571. Set mark after the inserted text.
  5572.  
  5573. This function is meant for the user to run interactively.
  5574. Don't call it from programs!  Use `insert-file-contents' instead.
  5575. (Its calling sequence is different; see its documentation).
  5576. Fappend-to-file
  5577. Append the contents of the region to the end of file FILENAME.
  5578. When called from a function, expects three arguments,
  5579. START, END and FILENAME.  START and END are buffer positions
  5580. saying what text to write.
  5581. Ffile-newest-backup
  5582. Return most recent backup file for FILENAME or nil if no backups exist.
  5583. Frename-uniquely
  5584. Rename current buffer to a similar name not already taken.
  5585. This function is useful for creating multiple shell process buffers
  5586. or multiple mail buffers, etc.
  5587. Fmake-directory
  5588. Create the directory DIR and any nonexistent parent dirs.
  5589. Interactively, the default choice of directory to create
  5590. is the current default directory for file names.
  5591. That is useful when you have visited a file in a nonexistint directory.
  5592.  
  5593. Noninteractively, the second (optional) argument PARENTS says whether
  5594. to create parent directories if they don't exist.
  5595. Vrevert-buffer-function
  5596. Function to use to revert this buffer, or nil to do the default.
  5597. Vrevert-buffer-insert-file-contents-function
  5598. Function to use to insert contents when reverting this buffer.
  5599. Gets two args, first the nominal file name to use,
  5600. and second, t if reading the auto-save file.
  5601. Frevert-buffer
  5602. Replace the buffer text with the text of the visited file on disk.
  5603. This undoes all changes since the file was visited or saved.
  5604. With a prefix argument, offer to revert from latest auto-save file, if
  5605. that is more recent than the visited file.
  5606.  
  5607. When called from lisp, the first argument is IGNORE-AUTO; only offer
  5608. to revert from the auto-save file when this is nil.  Note that the
  5609. sense of this argument is the reverse of the prefix argument, for the
  5610. sake of backward compatibility.  IGNORE-AUTO is optional, defaulting
  5611. to nil.
  5612.  
  5613. Optional second argument NOCONFIRM means don't ask for confirmation at
  5614. all.
  5615.  
  5616. If the value of `revert-buffer-function' is non-nil, it is called to
  5617. do the work.
  5618. Frecover-file
  5619. Visit file FILE, but get contents from its last auto-save file.
  5620. Fkill-some-buffers
  5621. For each buffer, ask whether to kill it.
  5622. Fauto-save-mode
  5623. Toggle auto-saving of contents of current buffer.
  5624. With prefix argument ARG, turn auto-saving on if positive, else off.
  5625. Frename-auto-save-file
  5626. Adjust current buffer's auto save file name for current conditions.
  5627. Also rename any existing auto save file, if it was made in this session.
  5628. Fmake-auto-save-file-name
  5629. Return file name to use for auto-saves of current buffer.
  5630. Does not consider `auto-save-visited-file-name' as that variable is checked
  5631. before calling this function.  You can redefine this for customization.
  5632. See also `auto-save-file-name-p'.
  5633. Fauto-save-file-name-p
  5634. Return non-nil if FILENAME can be yielded by `make-auto-save-file-name'.
  5635. FILENAME should lack slashes.  You can redefine this for customization.
  5636. Vlist-directory-brief-switches
  5637. *Switches for list-directory to pass to `ls' for brief listing,
  5638. Vlist-directory-verbose-switches
  5639. *Switches for list-directory to pass to `ls' for verbose listing,
  5640. Flist-directory
  5641. Display a list of files in or matching DIRNAME, a la `ls'.
  5642. DIRNAME is globbed by the shell if necessary.
  5643. Prefix arg (second arg if noninteractive) means supply -l switch to `ls'.
  5644. Actions controlled by variables `list-directory-brief-switches'
  5645. and `list-directory-verbose-switches'.
  5646. Vinsert-directory-program
  5647. Absolute or relative name of the `ls' program used by `insert-directory'.
  5648. Finsert-directory
  5649. Insert directory listing for FILE, formatted according to SWITCHES.
  5650. Leaves point after the inserted text.
  5651. Optional third arg WILDCARD means treat FILE as shell wildcard.
  5652. Optional fourth arg FULL-DIRECTORY-P means file is a directory and
  5653. switches do not contain `d', so that a full listing is expected.
  5654.  
  5655. This works by running a directory listing program
  5656. whose name is in the variable `insert-directory-program'.
  5657. If WILDCARD, it also runs the shell specified by `shell-file-name'.
  5658. Fsave-buffers-kill-emacs
  5659. Offer to save each buffer, then kill this Emacs process.
  5660. With prefix arg, silently save all file-visiting buffers, then kill.
  5661. Vfill-individual-varying-indent
  5662. *Controls criterion for a new paragraph in `fill-individual-paragraphs'.
  5663. Non-nil means changing indent doesn't end a paragraph.
  5664. That mode can handle paragraphs with extra indentation on the first line,
  5665. but it requires separator lines between paragraphs.
  5666. Nil means that any change in indentation starts a new paragraph.
  5667. Fset-fill-prefix
  5668. Set the fill-prefix to the current line up to point.
  5669. Filling expects lines to start with the fill prefix and
  5670. reinserts the fill prefix in each resulting line.
  5671. Vadaptive-fill-mode
  5672. *Non-nil means determine a paragraph's fill prefix from its text.
  5673. Vadaptive-fill-regexp
  5674. *Regexp to match text at start of line that constitutes indentation.
  5675. If Adaptive Fill mode is enabled, whatever text matches this pattern
  5676. on the second line of a paragraph is used as the standard indentation
  5677. for the paragraph.
  5678. Ffill-region-as-paragraph
  5679. Fill region as one paragraph: break lines to fit fill-column.
  5680. Prefix arg means justify too.
  5681. From program, pass args FROM, TO and JUSTIFY-FLAG.
  5682. Ffill-paragraph
  5683. Fill paragraph at or after point.  Prefix arg means justify as well.
  5684. Ffill-region
  5685. Fill each of the paragraphs in the region.
  5686. Prefix arg (non-nil third arg, if called from program) means justify as well.
  5687. Fjustify-current-line
  5688. Add spaces to line point is in, so it ends at `fill-column'.
  5689. Ffill-nonuniform-paragraphs
  5690. Fill paragraphs within the region, allowing varying indentation within each.
  5691. This command divides the region into "paragraphs",
  5692. only at paragraph-separator lines, then fills each paragraph
  5693. using as the fill prefix the smallest indentation of any line
  5694. in the paragraph.
  5695.  
  5696. When calling from a program, pass range to fill as first two arguments.
  5697.  
  5698. Optional third and fourth arguments JUSTIFY-FLAG and MAIL-FLAG:
  5699. JUSTIFY-FLAG to justify paragraphs (prefix arg),
  5700. MAIL-FLAG for a mail message, i. e. don't fill header lines.
  5701. Ffill-individual-paragraphs
  5702. Fill paragraphs of uniform indentation within the region.
  5703. This command divides the region into "paragraphs", 
  5704. treating every change in indentation level as a paragraph boundary,
  5705. then fills each paragraph using its indentation level as the fill prefix.
  5706.  
  5707. When calling from a program, pass range to fill as first two arguments.
  5708.  
  5709. Optional third and fourth arguments JUSTIFY-FLAG and MAIL-FLAG:
  5710. JUSTIFY-FLAG to justify paragraphs (prefix arg),
  5711. MAIL-FLAG for a mail message, i. e. don't fill header lines.
  5712. Vpi
  5713. The value of Pi (3.1415926...)
  5714. Ve
  5715. The value of e (2.7182818...)
  5716. Vdegrees-to-radians
  5717. Degrees to radian conversion constant
  5718. Vradians-to-degrees
  5719. Radian to degree conversion constant
  5720. Fdegrees-to-radians
  5721. Convert ARG from degrees to radians.
  5722. Fradians-to-degrees
  5723. Convert ARG from radians to degrees.
  5724. Vframe-creation-function
  5725. Window-system dependent function to call to create a new frame.
  5726. The window system startup file should set this to its frame creation
  5727. function, which should take an alist of parameters as its argument.
  5728. Vinitial-frame-alist
  5729. Alist of frame parameters for creating the initial X window frame.
  5730. You can set this in your `.emacs' file; for example,
  5731.  (setq initial-frame-alist '((top . 1) (left . 1) (width . 80) (height . 55)))
  5732. If the value calls for a frame without a minibuffer, and you do not create a
  5733. minibuffer frame on your own, one is created according to
  5734. `minibuffer-frame-alist'.
  5735. Parameters specified here supersede the values given in
  5736. `default-frame-alist'.
  5737. Vminibuffer-frame-alist
  5738. Alist of frame parameters for initially creating a minibuffer frame.
  5739. You can set this in your `.emacs' file; for example,
  5740.  (setq minibuffer-frame-alist
  5741.    '((top . 1) (left . 1) (width . 80) (height . 2)))
  5742. Parameters specified here supersede the values given in
  5743. `default-frame-alist'.
  5744. Vpop-up-frame-alist
  5745. Alist of frame parameters used when creating pop-up frames.
  5746. Pop-up frames are used for completions, help, and the like.
  5747. This variable can be set in your init file, like this:
  5748.   (setq pop-up-frame-alist '((width . 80) (height . 20)))
  5749. These supersede the values given in `default-frame-alist'.
  5750. Fnext-multiframe-window
  5751. Select the next window, regardless of which frame it is on.
  5752. Fprevious-multiframe-window
  5753. Select the previous window, regardless of which frame it is on.
  5754. Fmake-frame
  5755. Create a new frame, displaying the current buffer.
  5756.  
  5757. Optional argument PARAMETERS is an alist of parameters for the new
  5758. frame.  Specifically, PARAMETERS is a list of pairs, each having one
  5759. of the following forms:
  5760.  
  5761. (name . STRING)    - The frame should be named STRING.
  5762.  
  5763. (height . NUMBER) - The frame should be NUMBER text lines high.  If
  5764.     this parameter is present, the width parameter must also be
  5765.     given.
  5766.  
  5767. (width . NUMBER) - The frame should be NUMBER characters in width.
  5768.     If this parameter is present, the height parameter must also
  5769.     be given.
  5770.  
  5771. (minibuffer . t) - the frame should have a minibuffer
  5772. (minibuffer . nil) - the frame should have no minibuffer
  5773. (minibuffer . only) - the frame should contain only a minibuffer
  5774. (minibuffer . WINDOW) - the frame should use WINDOW as its minibuffer window.
  5775.  
  5776. The documentation for the function `x-create-frame' describes
  5777. additional frame parameters that Emacs recognizes for X window frames.
  5778. Ffiltered-frame-list
  5779. Return a list of all live frames which satisfy PREDICATE.
  5780. Fminibuffer-frame-list
  5781. Return a list of all frames with their own minibuffers.
  5782. Fframe-remove-geometry-params
  5783. Return the parameter list PARAM-LIST, but with geometry specs removed.
  5784. This deletes all bindings in PARAM-LIST for `top', `left', `width',
  5785. and `height' parameters.
  5786. Emacs uses this to avoid overriding explicit moves and resizings from
  5787. the user during startup.
  5788. Fother-frame
  5789. Select the ARG'th different visible frame, and raise it.
  5790. All frames are arranged in a cyclic order.
  5791. This command selects the frame ARG steps away in that order.
  5792. A negative ARG moves in the opposite order.
  5793. Fcurrent-frame-configuration
  5794. Return a list describing the positions and states of all frames.
  5795. Its car is `frame-configuration'.
  5796. Each element of the cdr is a list of the form (FRAME ALIST WINDOW-CONFIG),
  5797. where
  5798.   FRAME is a frame object,
  5799.   ALIST is an association list specifying some of FRAME's parameters, and
  5800.   WINDOW-CONFIG is a window configuration object for FRAME.
  5801. Fset-frame-configuration
  5802. Restore the frames to the state described by CONFIGURATION.
  5803. Each frame listed in CONFIGURATION has its position, size, window
  5804. configuration, and other parameters set as specified in CONFIGURATION.
  5805. Ordinarily, this function deletes all existing frames not
  5806. listed in CONFIGURATION.  But if optional second argument NODELETE
  5807. is given and non-nil, the unwanted frames are iconified instead.
  5808. Fframe-configuration-p
  5809. Return non-nil if OBJECT seems to be a frame configuration.
  5810. Any list whose car is `frame-configuration' is assumed to be a frame
  5811. configuration.
  5812. Fframe-height
  5813. Return number of lines available for display on FRAME.
  5814. If FRAME is omitted, describe the currently selected frame.
  5815. Fframe-width
  5816. Return number of columns available for display on FRAME.
  5817. If FRAME is omitted, describe the currently selected frame.
  5818. Fset-default-font
  5819. Set the font of the selected frame to FONT.
  5820. When called interactively, prompt for the name of the font to use.
  5821. Fset-background-color
  5822. Set the background color of the selected frame to COLOR.
  5823. When called interactively, prompt for the name of the color to use.
  5824. Fset-foreground-color
  5825. Set the foreground color of the selected frame to COLOR.
  5826. When called interactively, prompt for the name of the color to use.
  5827. Fset-cursor-color
  5828. Set the text cursor color of the selected frame to COLOR.
  5829. When called interactively, prompt for the name of the color to use.
  5830. Fset-mouse-color
  5831. Set the color of the mouse pointer of the selected frame to COLOR.
  5832. When called interactively, prompt for the name of the color to use.
  5833. Fset-border-color
  5834. Set the color of the border of the selected frame to COLOR.
  5835. When called interactively, prompt for the name of the color to use.
  5836. Fauto-raise-mode
  5837. Toggle whether or not the selected frame should auto-raise.
  5838. With arg, turn auto-raise mode on if and only if arg is positive.
  5839. Fauto-lower-mode
  5840. Toggle whether or not the selected frame should auto-lower.
  5841. With arg, turn auto-lower mode on if and only if arg is positive.
  5842. Ftoggle-scroll-bar
  5843. Toggle whether or not the selected frame has vertical scroll bars.
  5844. With arg, turn vertical scroll bars on if and only if arg is positive.
  5845. Ftoggle-horizontal-scroll-bar
  5846. Toggle whether or not the selected frame has horizontal scroll bars.
  5847. With arg, turn horizontal scroll bars on if and only if arg is positive.
  5848. Horizontal scroll bars aren't implemented yet.
  5849. Fset-screen-width
  5850. Obsolete function to change the size of the screen to COLS columns.
  5851. Optional second arg non-nil means that redisplay should use COLS columns
  5852. but that the idea of the actual width of the frame should not be changed.
  5853. This function is provided only for compatibility with Emacs 18; new code
  5854. should use `set-frame-width instead'.
  5855. Fset-screen-height
  5856. Obsolete function to change the height of the screen to LINES lines.
  5857. Optional second arg non-nil means that redisplay should use LINES lines
  5858. but that the idea of the actual height of the screen should not be changed.
  5859. This function is provided only for compatibility with Emacs 18; new code
  5860. should use `set-frame-width' instead.
  5861. Vctl-x-5-map
  5862. Keymap for frame commands.
  5863. Fmouse-delete-window
  5864. Delete the window you click on.
  5865. This must be bound to a mouse click.
  5866. Fmouse-tear-off-window
  5867. Delete the window clicked on, and create a new frame displaying its buffer.
  5868. Fmouse-delete-other-windows
  5869. Delete all window except the one you click on.
  5870. Fmouse-split-window-vertically
  5871. Select Emacs window mouse is on, then split it vertically in half.
  5872. The window is split at the line clicked on.
  5873. This command must be bound to a mouse click.
  5874. Fmouse-split-window-horizontally
  5875. Select Emacs window mouse is on, then split it horizontally in half.
  5876. The window is split at the column clicked on.
  5877. This command must be bound to a mouse click.
  5878. Fmouse-set-point
  5879. Move point to the position clicked on with the mouse.
  5880. This should be bound to a mouse click event type.
  5881. Fmouse-set-region
  5882. Set the region to the text dragged over, and copy to kill ring.
  5883. This should be bound to a mouse drag event.
  5884. Vmouse-scroll-delay
  5885. *The pause between scroll steps caused by mouse drags, in seconds.
  5886. If you drag the mouse beyond the edge of a window, Emacs scrolls the
  5887. window to bring the text beyond that edge into view, with a delay of
  5888. this many seconds between scroll steps.  Scrolling stops when you move
  5889. the mouse back into the window, or release the button.
  5890. This variable's value may be non-integral.
  5891. Setting this to zero causes Emacs to scroll as fast as it can.
  5892. Fmouse-scroll-subr
  5893. Scroll the selected window JUMP lines at a time, until new input arrives.
  5894. If OVERLAY is an overlay, let it stretch from START to the far edge of
  5895. the newly visible text.
  5896. Upon exit, point is at the far edge of the newly visible text.
  5897. Fmouse-drag-region
  5898. Set the region to the text that the mouse is dragged over.
  5899. Highlight the drag area as you move the mouse.
  5900. This must be bound to a button-down mouse event.
  5901. In Transient Mark mode, the highlighting remains once you
  5902. release the mouse button.  Otherwise, it does not.
  5903. Fmouse-skip-word
  5904. Skip over word, over whitespace, or over identical punctuation.
  5905. If DIR is positive skip forward; if negative, skip backward.
  5906. Fmouse-set-mark
  5907. Set mark at the position clicked on with the mouse.
  5908. Display cursor at that position for a second.
  5909. This must be bound to a mouse click.
  5910. Fmouse-kill
  5911. Kill the region between point and the mouse click.
  5912. The text is saved in the kill ring, as with \[kill-region].
  5913. Fmouse-yank-at-click
  5914. Insert the last stretch of killed text at the position clicked on.
  5915. Prefix arguments are interpreted as with \[yank].
  5916. Fmouse-kill-ring-save
  5917. Copy the region between point and the mouse click in the kill ring.
  5918. This does not delete the region; it acts like \[kill-ring-save].
  5919. Fmouse-save-then-kill
  5920. Save text to point in kill ring; the second time, kill the text.
  5921. If the text between point and the mouse is the same as what's
  5922. at the front of the kill ring, this deletes the text.
  5923. Otherwise, it adds the text to the kill ring, like \[kill-ring-save],
  5924. which prepares for a second click to delete the text.
  5925.  
  5926. If you have selected words or lines, this command extends the
  5927. selection through the word or line clicked on.  If you do this
  5928. again in a different position, it extends the selection again.
  5929. If you do this twice in the same position, the selection is killed.
  5930. Fmouse-start-secondary
  5931. Set one end of the secondary selection to the position clicked on.
  5932. Use \[mouse-secondary-save-then-kill] to set the other end
  5933. and complete the secondary selection.
  5934. Fmouse-set-secondary
  5935. Set the secondary selection to the text that the mouse is dragged over.
  5936. This must be bound to a mouse drag event.
  5937. Fmouse-drag-secondary
  5938. Set the secondary selection to the text that the mouse is dragged over.
  5939. Highlight the drag area as you move the mouse.
  5940. This must be bound to a button-down mouse event.
  5941. Fmouse-yank-secondary
  5942. Insert the last stretch of killed text at the position clicked on.
  5943. Prefix arguments are interpreted as with \[yank].
  5944. Fmouse-kill-secondary
  5945. Kill the text in the secondary selection.
  5946. This is intended more as a keyboard command than as a mouse command
  5947. but it can work as either one.
  5948.  
  5949. The current buffer (in case of keyboard use), or the buffer clicked on,
  5950. must be the one that the secondary selection is in.  This requirement
  5951. is to prevent accidents.
  5952. Fmouse-secondary-save-then-kill
  5953. Save text to point in kill ring; the second time, kill the text.
  5954. If the text between point and the mouse is the same as what's
  5955. at the front of the kill ring, this deletes the text.
  5956. Otherwise, it adds the text to the kill ring, like \[kill-ring-save],
  5957. which prepares for a second click to delete the text.
  5958.  
  5959. If you have selected words or lines, this command extends the
  5960. selection through the word or line clicked on.  If you do this
  5961. again in a different position, it extends the selection again.
  5962. If you do this twice in the same position, the selection is killed.
  5963. Fmouse-buffer-menu
  5964. Pop up a menu of buffers for selection with the mouse.
  5965. This switches buffers in the window that you clicked on,
  5966. and selects that window.
  5967. Fmouse-choose-completion
  5968. Click on an alternative in the `*Completions*' buffer to choose it.
  5969. Vx-fixed-font-alist
  5970. X fonts suitable for use in Emacs.
  5971. Fmouse-set-font
  5972. Select an emacs font from a list of known good fonts
  5973. Fx-get-selection
  5974. Return the value of an X Windows selection.
  5975. The argument TYPE (default `PRIMARY') says which selection, 
  5976. and the argument DATA-TYPE (default `STRING') says how to convert the data.
  5977. Fx-get-clipboard
  5978. Return text pasted to the clipboard.
  5979. Fx-set-selection
  5980. Make an X Windows selection of type TYPE and value DATA.
  5981. The argument TYPE (default `PRIMARY') says which selection, 
  5982. and DATA specifies the contents.  DATA may be a string,
  5983. a symbol, an integer (or a cons of two integers or list of two integers),
  5984. or a cons of two markers pointing to the same buffer.
  5985. In the last case, the selection is considered to be the text 
  5986. between the markers.
  5987. The data may also be a vector of valid non-vector selection values.
  5988. Fx-get-cut-buffer
  5989. Returns the value of one of the 8 X server cut-buffers.  Optional arg
  5990. WHICH-ONE should be a number from 0 to 7, defaulting to 0.
  5991. Cut buffers are considered obsolete; you should use selections instead.
  5992. Fx-set-cut-buffer
  5993. Store STRING into the X server's primary cut buffer.
  5994. If PUSH is non-nil, also rotate the cut buffers:
  5995. this means the previous value of the primary cut buffer moves the second
  5996. cut buffer, and the second to the third, and so on (there are 8 buffers.)
  5997. Cut buffers are considered obsolete; you should use selections instead.
  5998. Fxselect-convert-to-class
  5999. Emacs
  6000. Fxselect-convert-to-name
  6001. emacs
  6002. Fscroll-bar-scale
  6003. Given a pair (NUM . DENOM) and WHOLE, return (/ (* NUM WHOLE) DENOM).
  6004. This is handy for scaling a position on a scroll bar into real units,
  6005. like buffer positions.  If SCROLL-BAR-POS is the (PORTION . WHOLE) pair
  6006. from a scroll bar event, then (scroll-bar-scale SCROLL-BAR-POS
  6007. (buffer-size)) is the position in the current buffer corresponding to
  6008. that scroll bar position.
  6009. Fscroll-bar-mode
  6010. Toggle display of vertical scroll bars on each frame.
  6011. This command applies to all frames that exist and frames to be
  6012. created in the future.
  6013. With a numeric argument, if the argument is negative,
  6014. turn off scroll bars; otherwise, turn on scroll bars.
  6015. Fscroll-bar-set-window-start
  6016. Set the window start according to where the scroll bar is dragged.
  6017. EVENT should be a scroll bar click or drag event.
  6018. Fscroll-bar-drag
  6019. Scroll the window by dragging the scroll bar slider.
  6020. If you click outside the slider, the window scrolls to bring the slider there.
  6021. Fscroll-bar-scroll-down
  6022. Scroll the window's top line down to the location of the scroll bar click.
  6023. EVENT should be a scroll bar click.
  6024. Fscroll-bar-scroll-up
  6025. Scroll the line next to the scroll bar click to the top of the window.
  6026. EVENT should be a scroll bar click.
  6027. Vhelp-map
  6028. Keymap for characters following the Help key.
  6029. Fhelp-with-tutorial
  6030. Select the Emacs learn-by-doing tutorial.
  6031. Fdescribe-key-briefly
  6032. Print the name of the function KEY invokes.  KEY is a string.
  6033. Fprint-help-return-message
  6034. Display or return message saying how to restore windows after help command.
  6035. Computes a message and applies the optional argument FUNCTION to it.
  6036. If FUNCTION is nil, applies `message' to it, thus printing it.
  6037. Fdescribe-key
  6038. Display documentation of the function invoked by KEY.  KEY is a string.
  6039. Fdescribe-mode
  6040. Display documentation of current major mode.
  6041. If optional MINOR is non-nil (or prefix argument is given if interactive),
  6042. display documentation of active minor modes as well.
  6043. For this to work correctly for a minor mode, the mode's indicator variable
  6044. (listed in `minor-mode-alist') must also be a function whose documentation
  6045. describes the minor mode.
  6046. Fdescribe-distribution
  6047. Display info on how to obtain the latest version of GNU Emacs.
  6048. Fdescribe-copying
  6049. Display info on how you may redistribute copies of GNU Emacs.
  6050. Fdescribe-project
  6051. Display info on the GNU project.
  6052. Fdescribe-no-warranty
  6053. Display info on all the kinds of warranty Emacs does NOT have.
  6054. Fdescribe-prefix-bindings
  6055. Describe the bindings of the prefix used to reach this command.
  6056. The prefix described consists of all but the last event
  6057. of the key sequence that ran this command.
  6058. Fview-emacs-news
  6059. Display info on recent changes to Emacs.
  6060. Fview-lossage
  6061. Display last 100 input keystrokes.
  6062. Fhelp-for-help
  6063. You have typed \[help-command], the help character.  Type a Help option:
  6064.  
  6065. a  command-apropos.  Give a substring, and see a list of commands
  6066.     (functions interactively callable) that contain
  6067.     that substring.  See also the  apropos  command.
  6068. b  describe-bindings.  Display table of all key bindings.
  6069. c  describe-key-briefly.  Type a command key sequence;
  6070.     it prints the function name that sequence runs.
  6071. f  describe-function.  Type a function name and get documentation of it.
  6072. C-f Info-goto-emacs-command-node.  Type a function name;
  6073.     it takes you to the Info node for that command.
  6074. i  info. The  info  documentation reader.
  6075. k  describe-key.  Type a command key sequence;
  6076.     it displays the full documentation.
  6077. C-k Info-goto-emacs-key-command-node.  Type a command key sequence;
  6078.     it takes you to the Info node for the command bound to that key.
  6079. l  view-lossage.  Shows last 100 characters you typed.
  6080. m  describe-mode.  Print documentation of current major mode,
  6081.     which describes the commands peculiar to it.
  6082. n  view-emacs-news.  Shows emacs news file.
  6083. p  finder-by-keyword. Find packages matching a given topic keyword.
  6084. s  describe-syntax.  Display contents of syntax table, plus explanations
  6085. t  help-with-tutorial.  Select the Emacs learn-by-doing tutorial.
  6086. v  describe-variable.  Type name of a variable;
  6087.     it displays the variable's documentation and value.
  6088. w  where-is.  Type command name; it prints which keystrokes
  6089.     invoke that command.
  6090. C-c print Emacs copying permission (General Public License).
  6091. C-d print Emacs ordering information.
  6092. C-n print news of recent Emacs changes.
  6093. C-p print information about the GNU project.
  6094. C-w print information on absence of warranty for GNU Emacs.
  6095. Fdescribe-function
  6096. Display the full documentation of FUNCTION (a symbol).
  6097. Fdescribe-variable
  6098. Display the full documentation of VARIABLE (a symbol).
  6099. Returns the documentation as a string, also.
  6100. Fcommand-apropos
  6101. Like apropos but lists only symbols that are names of commands
  6102. (interactively callable functions).  Argument REGEXP is a regular expression
  6103. that is matched against command symbol names.  Returns list of symbols and
  6104. documentation found.
  6105. Flocate-library
  6106. Show the full path name of Emacs library LIBRARY.
  6107. This command searches the directories in `load-path' like `M-x load-library'
  6108. to find the file that `M-x load-library RET LIBRARY RET' would load.
  6109. Optional second arg NOSUFFIX non-nil means don't add suffixes `.elc' or `.el'
  6110. to the specified name LIBRARY (a la calling `load' instead of `load-library').
  6111. Vindent-line-function
  6112. Function to indent current line.
  6113. Findent-according-to-mode
  6114. Indent line in proper way for current major mode.
  6115. Findent-for-tab-command
  6116. Indent line in proper way for current major mode.
  6117. Findent-rigidly
  6118. Indent all lines starting in the region sideways by ARG columns.
  6119. Called from a program, takes three arguments, START, END and ARG.
  6120. Vindent-region-function
  6121. Function which is short cut to indent region using indent-according-to-mode.
  6122. A value of nil means really run indent-according-to-mode on each line.
  6123. Findent-region
  6124. Indent each nonblank line in the region.
  6125. With no argument, indent each line using `indent-according-to-mode',
  6126. or use `indent-region-function' to do the whole region if that's non-nil.
  6127. If there is a fill prefix, make each line start with the fill prefix.
  6128. With argument COLUMN, indent each line to that column.
  6129. Called from a program, takes three args: START, END and COLUMN.
  6130. Findent-relative-maybe
  6131. Indent a new line like previous nonblank line.
  6132. Findent-relative
  6133. Space out to under next indent point in previous nonblank line.
  6134. An indent point is a non-whitespace character following whitespace.
  6135. If the previous nonblank line has no indent points beyond the
  6136. column point starts at, `tab-to-tab-stop' is done instead.
  6137. Vtab-stop-list
  6138. *List of tab stop positions used by `tab-to-tab-stops'.
  6139. Vedit-tab-stops-map
  6140. Keymap used in `edit-tab-stops'.
  6141. Vedit-tab-stops-buffer
  6142. Buffer whose tab stops are being edited--in case
  6143. the variable `tab-stop-list' is local in that buffer.
  6144. Fedit-tab-stops
  6145. Edit the tab stops used by `tab-to-tab-stop'.
  6146. Creates a buffer *Tab Stops* containing text describing the tab stops.
  6147. A colon indicates a column where there is a tab stop.
  6148. You can add or remove colons and then do \<edit-tab-stops-map>\[edit-tab-stops-note-changes] to make changes take effect.
  6149. Fedit-tab-stops-note-changes
  6150. Put edited tab stops into effect.
  6151. Ftab-to-tab-stop
  6152. Insert spaces or tabs to next defined tab-stop column.
  6153. The variable `tab-stop-list' is a list of columns at which there are tab stops.
  6154. Use \[edit-tab-stops] to edit them interactively.
  6155. Fmove-to-tab-stop
  6156. Move point to next defined tab-stop column.
  6157. The variable `tab-stop-list' is a list of columns at which there are tab stops.
  6158. Use \[edit-tab-stops] to edit them interactively.
  6159. Vsearch-exit-option
  6160. *Non-nil means random control characters terminate incremental search.
  6161. Vsearch-slow-window-lines
  6162. *Number of lines in slow search display windows.
  6163. These are the short windows used during incremental search on slow terminals.
  6164. Negative means put the slow search window at the top (normally it's at bottom)
  6165. and the value is minus the number of lines.
  6166. Vsearch-slow-speed
  6167. *Highest terminal speed at which to use "slow" style incremental search.
  6168. This is the style where a one-line window is created to show the line
  6169. that the search has reached.
  6170. Vsearch-upper-case
  6171. *If non-nil, upper case chars disable case fold searching.
  6172. That is, upper and lower case chars must match exactly.
  6173. This applies no matter where the chars come from, but does not
  6174. apply to chars in regexps that are prefixed with `\'.
  6175. If this value is `not-yanks', yanked text is always downcased.
  6176. Vsearch-nonincremental-instead
  6177. *If non-nil, do a nonincremental search instead if exiting immediately.
  6178. Actually, `isearch-edit-string' is called to let you enter the search
  6179. string, and RET terminates editing and does a nonincremental search.
  6180. Vsearch-whitespace-regexp
  6181. *If non-nil, regular expression to match a sequence of whitespace chars.
  6182. You might want to use something like "[ \t\r\n]+" instead.
  6183. Vsearch-highlight
  6184. *Non-nil means incremental search highlights the current match.
  6185. Visearch-mode-hook
  6186. Function(s) to call after starting up an incremental search.
  6187. Visearch-mode-end-hook
  6188. Function(s) to call after terminating an incremental search.
  6189. Vsearch-ring
  6190. List of search string sequences.
  6191. Vregexp-search-ring
  6192. List of regular expression search string sequences.
  6193. Vsearch-ring-max
  6194. *Maximum length of search ring before oldest elements are thrown away.
  6195. Vregexp-search-ring-max
  6196. *Maximum length of regexp search ring before oldest elements are thrown away.
  6197. Vsearch-ring-yank-pointer
  6198. Index in `search-ring' of last string reused.
  6199. nil if none yet.
  6200. Vregexp-search-ring-yank-pointer
  6201. Index in `regexp-search-ring' of last string reused.
  6202. nil if none yet.
  6203. Vsearch-ring-update
  6204. *Non-nil if advancing or retreating in the search ring should cause search.
  6205. Default value, nil, means edit the string instead.
  6206. Visearch-mode-map
  6207. Keymap for isearch-mode.
  6208. Vminibuffer-local-isearch-map
  6209. Keymap for editing isearch strings in the minibuffer.
  6210. Fisearch-forward
  6211. Do incremental search forward.
  6212. With a prefix argument, do an incremental regular expression search instead.
  6213. \<isearch-mode-map>
  6214. As you type characters, they add to the search string and are found.
  6215. The following non-printing keys are bound in `isearch-mode-map'.  
  6216.  
  6217. Type \[isearch-delete-char] to cancel characters from end of search string.
  6218. Type \[isearch-exit] to exit, leaving point at location found.
  6219. Type LFD (C-j) to match end of line.
  6220. Type \[isearch-repeat-forward] to search again forward, \[isearch-repeat-backward] to search again backward.
  6221. Type \[isearch-yank-word] to yank word from buffer onto end of search string and search for it.
  6222. Type \[isearch-yank-line] to yank rest of line onto end of search string and search for it.
  6223. Type \[isearch-quote-char] to quote control character to search for it.
  6224. \[isearch-abort] while searching or when search has failed cancels input back to what has
  6225.  been found successfully.
  6226. \[isearch-abort] when search is successful aborts and moves point to starting point.
  6227.  
  6228. Also supported is a search ring of the previous 16 search strings.
  6229. Type \[isearch-ring-advance] to search for the next item in the search ring.
  6230. Type \[isearch-ring-retreat] to search for the previous item in the search ring.
  6231. Type \[isearch-complete] to complete the search string using the search ring.
  6232.  
  6233. The above keys, bound in `isearch-mode-map', are often controlled by 
  6234.  options; do M-x apropos on search-.* to find them.
  6235. Other control and meta characters terminate the search
  6236.  and are then executed normally (depending on `search-exit-option').
  6237.  
  6238. If this function is called non-interactively, it does not return to
  6239. the calling function until the search is done.
  6240. Fisearch-forward-regexp
  6241. Do incremental search forward for regular expression.
  6242. With a prefix argument, do a regular string search instead.
  6243. Like ordinary incremental search except that your input
  6244. is treated as a regexp.  See \[isearch-forward] for more info.
  6245. Fisearch-backward
  6246. Do incremental search backward.
  6247. With a prefix argument, do a regular expression search instead.
  6248. See \[isearch-forward] for more information.
  6249. Fisearch-backward-regexp
  6250. Do incremental search backward for regular expression.
  6251. With a prefix argument, do a regular string search instead.
  6252. Like ordinary incremental search except that your input
  6253. is treated as a regexp.  See \[isearch-forward] for more info.
  6254. Fisearch-mode
  6255. Start isearch minor mode.  Called by isearch-forward, etc.
  6256. Fisearch-exit
  6257. Exit search normally.
  6258. However, if this is the first command after starting incremental
  6259. search and `search-nonincremental-instead' is non-nil, do a
  6260. nonincremental search instead via `isearch-edit-string'.
  6261. Fisearch-edit-string
  6262. Edit the search string in the minibuffer.
  6263. The following additional command keys are active while editing.
  6264. \<minibuffer-local-isearch-map>
  6265. \[exit-minibuffer] to resume incremental searching with the edited string.
  6266. \[isearch-nonincremental-exit-minibuffer] to do one nonincremental search.
  6267. \[isearch-forward-exit-minibuffer] to resume isearching forward.
  6268. \[isearch-backward-exit-minibuffer] to resume isearching backward.
  6269. \[isearch-ring-advance-edit] to replace the search string with the next item in the search ring.
  6270. \[isearch-ring-retreat-edit] to replace the search string with the previous item in the search ring.
  6271. \[isearch-complete-edit] to complete the search string using the search ring.
  6272.  
  6273. If first char entered is \[isearch-yank-word], then do word search instead.
  6274. Fisearch-abort
  6275. Abort incremental search mode if searching is successful, signalling quit.
  6276. Otherwise, revert to previous successful search and continue searching.
  6277. Use `isearch-exit' to quit without signalling.
  6278. Fisearch-repeat-forward
  6279. Repeat incremental search forwards.
  6280. Fisearch-repeat-backward
  6281. Repeat incremental search backwards.
  6282. Fisearch-toggle-regexp
  6283. Toggle regexp searching on or off.
  6284. Fisearch-delete-char
  6285. Discard last input item and move point back.  
  6286. If no previous match was done, just beep.
  6287. Fisearch-yank-kill
  6288. Pull string from kill ring into search string.
  6289. Fisearch-yank-word
  6290. Pull next word from buffer into search string.
  6291. Fisearch-yank-line
  6292. Pull rest of line from buffer into search string.
  6293. Fisearch-*-char
  6294. Handle * and ? specially in regexps.
  6295. Fisearch-|-char
  6296. If in regexp search, jump to the barrier.
  6297. Fisearch-other-meta-char
  6298. Exit the search normally and reread this key sequence.
  6299. But only if `search-exit-option' is non-nil, the default.
  6300. If it is the symbol `edit', the search string is edited in the minibuffer
  6301. and the meta character is unread so that it applies to editing the string.
  6302. Fisearch-quote-char
  6303. Quote special characters for incremental search.
  6304. Fisearch-return-char
  6305. Convert return into newline for incremental search.
  6306. Obsolete.
  6307. Fisearch-printing-char
  6308. Add this ordinary printing character to the search string and search.
  6309. Fisearch-whitespace-chars
  6310. Match all whitespace chars, if in regexp mode.
  6311. If you want to search for just a space, type C-q SPC.
  6312. Fisearch-ring-advance
  6313. Advance to the next search string in the ring.
  6314. Fisearch-ring-retreat
  6315. Retreat to the previous search string in the ring.
  6316. Fisearch-ring-advance-edit
  6317. Insert the next element of the search history into the minibuffer.
  6318. Fisearch-ring-retreat-edit
  6319. Inserts the previous element of the search history into the minibuffer.
  6320. Fisearch-complete
  6321. Complete the search string from the strings on the search ring.
  6322. The completed string is then editable in the minibuffer.
  6323. If there is no completion possible, say so and continue searching.
  6324. Fisearch-complete-edit
  6325. Same as `isearch-complete' except in the minibuffer.
  6326. Fisearch-no-upper-case-p
  6327. Return t if there are no upper case chars in STRING.
  6328. If REGEXP-FLAG is non-nil, disregard letters preceeded by `\' (but not `\\')
  6329. since they have special meaning in a regexp.
  6330. Vlisp-mode-syntax-table
  6331.  
  6332. Vemacs-lisp-mode-syntax-table
  6333.  
  6334. Vlisp-mode-abbrev-table
  6335.  
  6336. Vshared-lisp-mode-map
  6337. Keymap for commands shared by all sorts of Lisp modes.
  6338. Vemacs-lisp-mode-map
  6339. Keymap for Emacs Lisp mode.
  6340. All commands in shared-lisp-mode-map are inherited by this map.
  6341. Femacs-lisp-mode
  6342. Major mode for editing Lisp code to run in Emacs.
  6343. Commands:
  6344. Delete converts tabs to spaces as it moves back.
  6345. Blank lines separate paragraphs.  Semicolons start comments.
  6346. \{emacs-lisp-mode-map}
  6347. Entry to this mode calls the value of `emacs-lisp-mode-hook'
  6348. if that value is non-nil.
  6349. Vlisp-mode-map
  6350. Keymap for ordinary Lisp mode.
  6351. All commands in `shared-lisp-mode-map' are inherited by this map.
  6352. Flisp-mode
  6353. Major mode for editing Lisp code for Lisps other than GNU Emacs Lisp.
  6354. Commands:
  6355. Delete converts tabs to spaces as it moves back.
  6356. Blank lines separate paragraphs.  Semicolons start comments.
  6357. \{lisp-mode-map}
  6358. Note that `run-lisp' may be used either to start an inferior Lisp job
  6359. or to switch back to an existing one.
  6360.  
  6361. Entry to this mode calls the value of `lisp-mode-hook'
  6362. if that value is non-nil.
  6363. Flisp-eval-defun
  6364. Send the current defun to the Lisp process made by \[run-lisp].
  6365. Vlisp-interaction-mode-map
  6366. Keymap for Lisp Interaction moe.
  6367. All commands in `shared-lisp-mode-map' are inherited by this map.
  6368. Flisp-interaction-mode
  6369. Major mode for typing and evaluating Lisp forms.
  6370. Like Lisp mode except that \[eval-print-last-sexp] evals the Lisp expression
  6371. before point, and prints its value into the buffer, advancing point.
  6372.  
  6373. Commands:
  6374. Delete converts tabs to spaces as it moves back.
  6375. Paragraphs are separated only by blank lines.
  6376. Semicolons start comments.
  6377. \{lisp-interaction-mode-map}
  6378. Entry to this mode calls the value of `lisp-interaction-mode-hook'
  6379. if that value is non-nil.
  6380. Feval-print-last-sexp
  6381. Evaluate sexp before point; print value into current buffer.
  6382. Feval-last-sexp
  6383. Evaluate sexp before point; print value in minibuffer.
  6384. With argument, print output into current buffer.
  6385. Feval-defun
  6386. Evaluate defun that point is in or before.
  6387. Print value in minibuffer.
  6388. With argument, insert value in current buffer after the defun.
  6389. Vlisp-indent-offset
  6390.  
  6391. Vlisp-indent-function
  6392.  
  6393. Flisp-indent-line
  6394. Indent current line as Lisp code.
  6395. With argument, indent any additional lines of the same expression
  6396. rigidly along with this one.
  6397. Fcalculate-lisp-indent
  6398. Return appropriate indentation for current line as Lisp code.
  6399. In usual case returns an integer: the column to indent to.
  6400. Can instead return a list, whose car is the column to indent to.
  6401. This means that following lines at the same level of indentation
  6402. should not necessarily be indented the same way.
  6403. The second element of the list is the buffer position
  6404. of the start of the containing expression.
  6405. Vlisp-body-indent
  6406. Number of columns to indent the second line of a `(def...)' form.
  6407. Findent-sexp
  6408. Indent each line of the list starting just after point.
  6409. If optional arg ENDPOS is given, indent each line, stopping when
  6410. ENDPOS is encountered.
  6411. Flisp-fill-paragraph
  6412. Like \[fill-paragraph], but handle Emacs Lisp comments.
  6413. If any of the current line is a comment, fill the comment or the
  6414. paragraph of it that point is in, preserving the comment's indentation
  6415. and initial semicolons.
  6416. Findent-code-rigidly
  6417. Indent all lines of code, starting in the region, sideways by ARG columns.
  6418. Does not affect lines starting inside comments or strings, assuming that
  6419. the start of the region is not inside them.
  6420.  
  6421. Called from a program, takes args START, END, COLUMNS and NOCHANGE-REGEXP.
  6422. The last is a regexp which, if matched at the beginning of a line,
  6423. means don't indent that line.
  6424. Vdefun-prompt-regexp
  6425. Non-nil => regexp to ignore, before the `(' that starts a defun.
  6426. Vparens-require-spaces
  6427. Non-nil => `insert-parentheses' should insert whitespace as needed.
  6428. Fforward-sexp
  6429. Move forward across one balanced expression (sexp).
  6430. With argument, do it that many times.  Negative arg -N means
  6431. move backward across N balanced expressions.
  6432. Fbackward-sexp
  6433. Move backward across one balanced expression (sexp).
  6434. With argument, do it that many times.  Negative arg -N means
  6435. move forward across N balanced expressions.
  6436. Fmark-sexp
  6437. Set mark ARG sexps from point.
  6438. The place mark goes is the same place \[forward-sexp] would
  6439. move to with the same argument.
  6440. Fforward-list
  6441. Move forward across one balanced group of parentheses.
  6442. With argument, do it that many times.
  6443. Negative arg -N means move backward across N groups of parentheses.
  6444. Fbackward-list
  6445. Move backward across one balanced group of parentheses.
  6446. With argument, do it that many times.
  6447. Negative arg -N means move forward across N groups of parentheses.
  6448. Fdown-list
  6449. Move forward down one level of parentheses.
  6450. With argument, do this that many times.
  6451. A negative argument means move backward but still go down a level.
  6452. In Lisp programs, an argument is required.
  6453. Fbackward-up-list
  6454. Move backward out of one level of parentheses.
  6455. With argument, do this that many times.
  6456. A negative argument means move forward but still to a less deep spot.
  6457. In Lisp programs, an argument is required.
  6458. Fup-list
  6459. Move forward out of one level of parentheses.
  6460. With argument, do this that many times.
  6461. A negative argument means move backward but still to a less deep spot.
  6462. In Lisp programs, an argument is required.
  6463. Fkill-sexp
  6464. Kill the sexp (balanced expression) following the cursor.
  6465. With argument, kill that many sexps after the cursor.
  6466. Negative arg -N means kill N sexps before the cursor.
  6467. Fbackward-kill-sexp
  6468. Kill the sexp (balanced expression) preceding the cursor.
  6469. With argument, kill that many sexps before the cursor.
  6470. Negative arg -N means kill N sexps after the cursor.
  6471. Fbeginning-of-defun
  6472. Move backward to the beginning of a defun.
  6473. With argument, do it that many times.  Negative arg -N
  6474. means move forward to Nth following beginning of defun.
  6475. Returns t unless search stops due to beginning or end of buffer.
  6476.  
  6477. Normally a defun starts when there is an char with open-parenthesis
  6478. syntax at the beginning of a line.  If `defun-prompt-regexp' is
  6479. non-nil, then a string which matches that regexp may precede the
  6480. open-parenthesis.
  6481. Fend-of-defun
  6482. Move forward to next end of defun.  With argument, do it that many times.
  6483. Negative argument -N means move back to Nth preceding end of defun.
  6484.  
  6485. An end of a defun occurs right after the close-parenthesis that matches
  6486. the open-parenthesis that starts a defun; see `beginning-of-defun'.
  6487. Fmark-defun
  6488. Put mark at end of this defun, point at beginning.
  6489. The defun marked is the one that contains point or follows point.
  6490. Finsert-parentheses
  6491. Put parentheses around next ARG sexps.  Leave point after open-paren.
  6492. No argument is equivalent to zero: just insert `()' and leave point between.
  6493. This command also sometimes inserts a space before and after,
  6494. depending on the surrounding characters.
  6495. Fmove-past-close-and-reindent
  6496. Move past next `)', delete indentation before it, then indent after it.
  6497. Flisp-complete-symbol
  6498. Perform completion on Lisp symbol preceding point.  That symbol is
  6499. compared against the symbols that exist and any additional characters
  6500. determined by what is there are inserted.
  6501.    If the symbol starts just after an open-parenthesis, only symbols
  6502. with function definitions are considered.  Otherwise, all symbols with
  6503. function definitions, values or properties are considered.
  6504. Vminor-mode-alist
  6505. Alist saying how to show minor modes in the mode line.
  6506. Each element looks like (VARIABLE STRING);
  6507. STRING is included in the mode line iff VARIABLE's value is non-nil.
  6508.  
  6509. Actually, STRING need not be a string; any possible mode-line element
  6510. is okay.  See `mode-line-format'.
  6511. Fprompt-for-change-log-name
  6512. Prompt for a change log name.
  6513. Ffind-change-log
  6514. Find a change log file for \[add-change-log-entry] and return the name.
  6515. Optional arg FILE-NAME is a name to try first.
  6516. If FILE-NAME is nil, use the value of `change-log-default-name' if non-nil.
  6517. Failing that, use "ChangeLog" in the current directory.
  6518. If the file does not exist in the named directory, successive parent
  6519. directories are tried.
  6520.  
  6521. Once a file is found, `change-log-default-name' is set locally in the
  6522. current buffer to the complete file name.
  6523. Fadd-change-log-entry
  6524. Find change log file and add an entry for today.
  6525. Optional arg (interactive prefix) non-nil means prompt for user name and site.
  6526. Second arg is file name of change log.  If nil, uses `change-log-default-name'.
  6527. Third arg OTHER-WINDOW non-nil means visit in other window.
  6528. Fourth arg NEW-ENTRY non-nil means always create a new entry at the front;
  6529. never append to an existing entry.
  6530. Fadd-change-log-entry-other-window
  6531. Find change log file in other window and add an entry for today.
  6532. Optional arg (interactive prefix) non-nil means prompt for user name and site.
  6533. Second arg is file name of change log.  If nil, uses `change-log-default-name'.
  6534. Fchange-log-mode
  6535. Major mode for editing change logs; like Indented Text Mode.
  6536. Prevents numeric backups and sets `left-margin' to 8 and `fill-column' to 74.
  6537. New log entries are usually made with \[add-change-log-entry] or \[add-change-log-entry-other-window].
  6538. Each entry behaves as a paragraph, and the entries for one day as a page.
  6539. Runs `change-log-mode-hook'.
  6540. Vad-start-advice-on-load
  6541. *Non-NIL will start advice magic when this file gets loaded.
  6542. Also see function `ad-start-advice'.
  6543. Vad-activate-on-definition
  6544. *Non-NIL means automatic advice activation at function definition.
  6545. Set this variable to t if you want to enable forward advice (which is
  6546. automatic advice activation of a previously undefined function at the
  6547. point the function gets defined/loaded/autoloaded). The value of this
  6548. variable takes effect only during the execution of `ad-start-advice'. 
  6549. If non-NIL it will enable definition hooks regardless of the value
  6550. of `ad-enable-definition-hooks'.
  6551. Vad-redefinition-action
  6552. *Defines what to do with redefinitions during de/activation.
  6553. Redefinition occurs if a previously activated function that already has an
  6554. original definition associated with it gets redefined and then de/activated.
  6555. In such a case we can either accept the current definition as the new
  6556. original definition, discard the current definition and replace it with the
  6557. old original, or keep it and raise an error. The values `accept', `discard',
  6558. `error' or `warn' govern what will be done. `warn' is just like `accept' but
  6559. it additionally prints a warning message. All other values will be
  6560. interpreted as `error'.
  6561. Vad-definition-hooks
  6562. *List of hooks to be run after a function definition.
  6563. The variable `ad-defined-function' will be bound to the name of
  6564. the currently defined function when the hook function is run.
  6565. Vad-enable-definition-hooks
  6566. *Non-NIL will enable hooks to be run on function definition.
  6567. Setting this variable is a noop unless the value of
  6568. `ad-activate-on-definition' (which see) is NIL.
  6569. Vad-use-jwz-byte-compiler
  6570. *Non-NIL means Jamie Zawinski's v19 byte-compiler will be used.
  6571. If you use a v18 Emacs and don't use jwz's optimizing byte-compiler (the
  6572. normal case) then this variable should be NIL, because otherwise
  6573. enabling definition hooks (e.g., for forward advice) will redefine the 
  6574. `byte-code' subr which will lead to some performance degradation for
  6575. byte-compiled code.
  6576. Fad-add-advice
  6577. Adds a piece of ADVICE to FUNCTION's list of advices in CLASS.
  6578. If FUNCTION already has one or more pieces of advice of the specified
  6579. CLASS then POSITION determines where the new piece will go. The value
  6580. of POSITION can either be `first', `last' or a number where 0 corresponds
  6581. to `first'. Numbers outside the range will be mapped to the closest
  6582. extreme position. If there was already a piece of ADVICE with the same
  6583. name, then the position argument will be ignored and the old advice
  6584. will be overwritten with the new one.
  6585.     If the FUNCTION was not advised already, then its advice info will be 
  6586. initialized. Redefining a piece of advice whose name is part of the cache-id
  6587. will clear the cache.
  6588. Fdefadvice
  6589. Defines a piece of advice for FUNCTION (a symbol).
  6590.  
  6591.   (defadvice <function> (<class> <name> [<position>] [<arglist>] {<flags>}*)
  6592.     [ [<documentation-string>] [<interactive-form>] ]
  6593.     {<body-form>}* )
  6594.  
  6595. <function> ::= name of the function to be advised
  6596. <class> ::= before | around | after | activation | deactivation
  6597. <name> ::= non-NIL symbol that names this piece of advice
  6598. <position> ::= first | last | <number> (optional, defaults to `first',
  6599.     see also `ad-add-advice')
  6600. <arglist> ::= an optional argument list to be used for the advised function
  6601.     instead of the argument list of the original. The first one found in
  6602.     before/around/after advices will be used.
  6603. <flags> ::= protect | disable | activate | compile | preactivate
  6604.     All flags can be specified with unambiguous initial substrings.
  6605. <documentation-string> ::= optional documentation for this piece of advice
  6606. <interactive-form> ::= optional interactive form to be used for the advised
  6607.     function. The first one found in before/around/after advices will be used.
  6608. <body-form> ::= any s-expression
  6609.  
  6610. Semantics of the various flags:
  6611. `protect': The piece of advice will be protected against non-local exits in
  6612. any code that precedes it. If any around advice of a function is protected
  6613. then automatically all around advices will be protected (the complete onion).
  6614.  
  6615. `activate': All advice of FUNCTION will be activated immediately if
  6616. FUNCTION has been properly defined prior to the defadvice.
  6617.  
  6618. `compile': In conjunction with `activate' specifies that the resulting
  6619. advised function should be compiled.
  6620.  
  6621. `disable': The defined advice will be disabled, hence it will not be used 
  6622. during activation until somebody enables it.
  6623.  
  6624. `preactivate': Preactivates the advised FUNCTION at macro expansion/compile
  6625. time. This generates a compiled advised definition according to the current
  6626. advice state that will be used during activation if appropriate. Only use
  6627. this if the defadvice gets actually compiled (with a v18 byte-compiler put
  6628. the defadvice into the body of a defun).
  6629.  
  6630. Look at the file advice.el for comprehensive documentation.
  6631. Fad-start-advice
  6632. Redefines some primitives to start the advice magic.
  6633. If `ad-activate-on-definition' is t then advice information will
  6634. automatically get activated whenever an advised function gets defined or
  6635. redefined.  This will enable goodies such as forward advice and
  6636. automatically enable function definition hooks. If its value is nil but
  6637. the value of `ad-enable-definition-hooks' is t then definition hooks
  6638. will be enabled without having automatic advice activation, otherwise
  6639. function definition hooks will be disabled too. If definition hooks are
  6640. enabled then functions stored in `ad-definition-hooks' are run whenever
  6641. a function gets defined or redefined.
  6642. Vappt-issue-message
  6643. *Non-nil means check for appointments in the diary buffer.
  6644. To be detected, the diary entry must have the time
  6645. as the first thing on a line.
  6646. Vappt-message-warning-time
  6647. *Time in minutes before an appointment that the warning begins.
  6648. Vappt-audible
  6649. *Non-nil means beep to indicate appointment.
  6650. Vappt-visible
  6651. *Non-nil means display appointment message in echo area.
  6652. Vappt-display-mode-line
  6653. *Non-nil means display minutes to appointment and time on the mode line.
  6654. Vappt-msg-window
  6655. *Non-nil means display appointment message in another window.
  6656. Vappt-display-duration
  6657. *The number of seconds an appointment message is displayed.
  6658. Vappt-display-diary
  6659. *Non-nil means to display the next days diary on the screen. 
  6660. This will occur at midnight when the appointment list is updated.
  6661. Fapropos
  6662. Show all symbols whose names contain matches for REGEXP.
  6663. If optional argument DO-ALL is non-nil, does more (time-consuming) work such as
  6664. showing key bindings.  Optional argument PRED is called with each symbol, and
  6665. if it returns nil, the symbol is not shown.
  6666.  
  6667. Returns list of symbols and documentation found.
  6668. Fsuper-apropos
  6669. Show symbols whose names/documentation contain matches for REGEXP.
  6670. If optional argument DO-ALL is non-nil, does more (time-consuming) work such as
  6671. showing key bindings and documentation that is not stored in the documentation
  6672. file.
  6673.  
  6674. Returns list of symbols and documentation found.
  6675. Fasm-mode
  6676. Major mode for editing typical assembler code.
  6677. Features a private abbrev table and the following bindings:
  6678.  
  6679. \[asm-colon]    outdent a preceding label, tab to next tab stop.
  6680. \[tab-to-tab-stop]    tab to next tab stop.
  6681. \[asm-newline]    newline, then tab to next tab stop.
  6682. \[asm-comment]    smart placement of assembler comments.
  6683.  
  6684. The character used for making comments is set by the variable
  6685. `asm-comment-char' (which defaults to `?;').
  6686.  
  6687. Alternatively, you may set this variable in `asm-set-comment-hook', which is
  6688. called near the beginning of mode initialization.
  6689.  
  6690. Turning on Asm mode runs the hook `asm-mode-hook' at the end of initialization.
  6691.  
  6692. Special commands:\{asm-mode-map}
  6693.  
  6694. Fupdate-file-autoloads
  6695. Update the autoloads for FILE in `generated-autoload-file'
  6696. (which FILE might bind in its local variables).
  6697. Fupdate-autoloads-here
  6698. Update sections of the current buffer generated by \[update-file-autoloads].
  6699. Fupdate-directory-autoloads
  6700. Run \[update-file-autoloads] on each .el file in DIR.
  6701. Fbatch-update-autoloads
  6702. Update the autoloads for the files or directories on the command line.
  6703. Runs \[update-file-autoloads] on files and \[update-directory-autoloads]
  6704. on directories.  Must be used only with -batch, and kills Emacs on completion.
  6705. Each file will be processed even if an error occurred previously.
  6706. For example, invoke "emacs -batch -f batch-update-autoloads *.el"
  6707. Fawk-mode
  6708. Major mode for editing AWK code.
  6709. This is much like C mode except for the syntax of comments.  It uses
  6710. the same keymap as C mode and has the same variables for customizing
  6711. indentation.  It has its own abbrev table and its own syntax table.
  6712.  
  6713. Turning on AWK mode calls the value of the variable `awk-mode-hook'
  6714. with no args, if that value is non-nil.
  6715. Fq
  6716. (` FORM)  is a macro that expands to code to construct FORM.
  6717. Note that this is very slow in interpreted code, but fast if you compile.
  6718. FORM is one or more nested lists, which are `almost quoted':
  6719. They are copied recursively, with non-lists used unchanged in the copy.
  6720.  (` a b) == (list 'a 'b)  constructs a new list with two elements, `a' and `b'.
  6721.  (` a (b c)) == (list 'a (list 'b 'c))  constructs two nested new lists.
  6722.  
  6723. However, certain special lists are not copied.  They specify substitution.
  6724. Lists that look like (, EXP) are evaluated and the result is substituted.
  6725.  (` a (, (+ x 5))) == (list 'a (+ x 5))
  6726.  
  6727. Elements of the form (,@ EXP) are evaluated and then all the elements
  6728. of the result are substituted.  This result must be a list; it may
  6729. be `nil'.
  6730.  
  6731. As an example, a simple macro `push' could be written:
  6732.    (defmacro push (v l)
  6733.         (` (setq (, l) (cons (,@ (list v l))))))
  6734. or as
  6735.    (defmacro push (v l)
  6736.         (` (setq (, l) (cons (, v) (, l)))))
  6737.  
  6738. LIMITATIONS: "dotted lists" are not allowed in FORM.
  6739. The ultimate cdr of each list scanned by ` must be `nil'.
  6740. (This does not apply to constants inside expressions to be substituted.)
  6741.  
  6742. Substitution elements are not allowed as the cdr
  6743. of a cons cell.  For example, (` (A . (, B))) does not work.
  6744. Instead, write (` (A (,@ B))).
  6745.  
  6746. You cannot construct vectors, only lists.  Vectors are treated as
  6747. constants.
  6748.  
  6749. BEWARE BEWARE BEWARE
  6750. Inclusion of (,ATOM) rather than (, ATOM)
  6751. or of (,@ATOM) rather than (,@ ATOM)
  6752. will result in errors that will show up very late.
  6753. Fbibtex-mode
  6754. Major mode for editing bibtex files.
  6755.  
  6756. \{bibtex-mode-map}
  6757.  
  6758. A command such as \[bibtex-Book] will outline the fields for a BibTeX book entry.
  6759.  
  6760. The optional fields start with the string OPT, and thus ignored by BibTeX.
  6761. The OPT string may be removed from a field with \[bibtex-remove-OPT].
  6762. \[bibtex-kill-optional-field] kills the current optional field entirely.
  6763. \[bibtex-remove-double-quotes] removes the double-quotes around the text of
  6764. the current field.  \[bibtex-empty-field] replaces the text of the current
  6765. field with the default "".
  6766.  
  6767. The command \[bibtex-clean-entry] cleans the current entry, i.e. (i) removes
  6768. double-quotes from entirely numerical fields, (ii) removes OPT from all
  6769. non-empty optional fields, (iii) removes all empty optional fields, and (iv)
  6770. checks that no non-optional fields are empty.
  6771.  
  6772. Use \[bibtex-find-text] to position the dot at the end of the current field.
  6773. Use \[bibtex-next-field] to move to end of the next field.
  6774.  
  6775. The following may be of interest as well:
  6776.  
  6777.   Functions:
  6778.     find-bibtex-duplicates
  6779.     find-bibtex-entry-location
  6780.     hide-bibtex-entry-bodies
  6781.     sort-bibtex-entries
  6782.     validate-bibtex-buffer
  6783.  
  6784.   Variables:
  6785.     bibtex-clean-entry-zap-empty-opts
  6786.     bibtex-entry-field-alist
  6787.     bibtex-include-OPTannote
  6788.     bibtex-include-OPTcrossref
  6789.     bibtex-include-OPTkey
  6790.     bibtex-maintain-sorted-entries
  6791.     bibtex-mode-user-optional-fields
  6792.  
  6793. Fields:
  6794.     address
  6795.            Publisher's address
  6796.     annote
  6797.            Long annotation used for annotated bibliographies (begins sentence)
  6798.     author
  6799.            Name(s) of author(s), in BibTeX name format
  6800.     booktitle
  6801.            Book title when the thing being referenced isn't the whole book.
  6802.            For book entries, the title field should be used instead.
  6803.     chapter
  6804.            Chapter number
  6805.     crossref
  6806.        The database key of the entry being cross referenced.
  6807.     edition
  6808.            Edition of a book (e.g., "second")
  6809.     editor
  6810.            Name(s) of editor(s), in BibTeX name format.
  6811.            If there is also an author field, then the editor field should be
  6812.            for the book or collection that the work appears in
  6813.     howpublished
  6814.             How something strange has been published (begins sentence)
  6815.     institution
  6816.            Sponsoring institution
  6817.     journal
  6818.            Journal name (macros are provided for many)
  6819.     key
  6820.            Alphabetizing and labeling key (needed when no author or editor)
  6821.     month
  6822.            Month (macros are provided)
  6823.     note
  6824.            To help the reader find a reference (begins sentence)
  6825.     number
  6826.            Number of a journal or technical report
  6827.     organization
  6828.            Organization (sponsoring a conference)
  6829.     pages
  6830.            Page number or numbers (use `--' to separate a range)
  6831.     publisher
  6832.            Publisher name
  6833.     school
  6834.            School name (for theses)
  6835.     series
  6836.            The name of a series or set of books.
  6837.            An individual book will will also have it's own title
  6838.     title
  6839.            The title of the thing being referenced
  6840.     type
  6841.            Type of a technical report (e.g., "Research Note") to be used
  6842.            instead of the default "Technical Report"
  6843.     volume
  6844.            Volume of a journal or multivolume work
  6845.     year
  6846.            Year---should contain only numerals
  6847. ---------------------------------------------------------
  6848. Entry to this mode calls the value of bibtex-mode-hook if that value is
  6849. non-nil.
  6850. Fblackbox
  6851. Play blackbox.  Optional prefix argument is the number of balls;
  6852. the default is 4.
  6853.  
  6854. What is blackbox?
  6855.  
  6856. Blackbox is a game of hide and seek played on an 8 by 8 grid (the
  6857. Blackbox).  Your opponent (Emacs, in this case) has hidden several
  6858. balls (usually 4) within this box.  By shooting rays into the box and
  6859. observing where they emerge it is possible to deduce the positions of
  6860. the hidden balls.  The fewer rays you use to find the balls, the lower
  6861. your score.
  6862.  
  6863. Overview of play:
  6864.  
  6865. \<blackbox-mode-map>To play blackbox, type \[blackbox].  An optional prefix argument
  6866. specifies the number of balls to be hidden in the box; the default is
  6867. four.
  6868.  
  6869. The cursor can be moved around the box with the standard cursor
  6870. movement keys.
  6871.  
  6872. To shoot a ray, move the cursor to the edge of the box and press SPC.
  6873. The result will be determined and the playfield updated.
  6874.  
  6875. You may place or remove balls in the box by moving the cursor into the
  6876. box and pressing \[bb-romp].
  6877.  
  6878. When you think the configuration of balls you have placed is correct,
  6879. press \[bb-done].  You will be informed whether you are correct or
  6880. not, and be given your score.  Your score is the number of letters and
  6881. numbers around the outside of the box plus five for each incorrectly
  6882. placed ball.  If you placed any balls incorrectly, they will be
  6883. indicated with `x', and their actual positions indicated with `o'.
  6884.  
  6885. Details:
  6886.  
  6887. There are three possible outcomes for each ray you send into the box:
  6888.  
  6889.     Detour: the ray is deflected and emerges somewhere other than
  6890.         where you sent it in.  On the playfield, detours are
  6891.         denoted by matching pairs of numbers -- one where the
  6892.         ray went in, and the other where it came out.
  6893.  
  6894.     Reflection: the ray is reflected and emerges in the same place
  6895.         it was sent in.  On the playfield, reflections are
  6896.         denoted by the letter `R'.
  6897.  
  6898.     Hit:    the ray strikes a ball directly and is absorbed.  It does
  6899.         not emerge from the box.  On the playfield, hits are
  6900.         denoted by the letter `H'.
  6901.  
  6902. The rules for how balls deflect rays are simple and are best shown by
  6903. example.
  6904.  
  6905. As a ray approaches a ball it is deflected ninety degrees.  Rays can
  6906. be deflected multiple times.  In the diagrams below, the dashes
  6907. represent empty box locations and the letter `O' represents a ball.
  6908. The entrance and exit points of each ray are marked with numbers as
  6909. described under "Detour" above.  Note that the entrance and exit
  6910. points are always interchangeable.  `*' denotes the path taken by the
  6911. ray.
  6912.  
  6913. Note carefully the relative positions of the ball and the ninety
  6914. degree deflection it causes.
  6915.  
  6916.     1                                            
  6917.   - * - - - - - -         - - - - - - - -         - - - - - - - -       
  6918.   - * - - - - - -         - - - - - - - -         - - - - - - - -       
  6919. 1 * * - - - - - -         - - - - - - - -         - O - - - - O -       
  6920.   - - O - - - - -         - - O - - - - -         - - * * * * - -
  6921.   - - - - - - - -         - - - * * * * * 2     3 * * * - - * - -
  6922.   - - - - - - - -         - - - * - - - -         - - - O - * - -      
  6923.   - - - - - - - -         - - - * - - - -         - - - - * * - -       
  6924.   - - - - - - - -         - - - * - - - -         - - - - * - O -       
  6925.                                 2                         3
  6926.  
  6927. As mentioned above, a reflection occurs when a ray emerges from the same point
  6928. it was sent in.  This can happen in several ways:
  6929.  
  6930.                                                                            
  6931.   - - - - - - - -         - - - - - - - -          - - - - - - - -
  6932.   - - - - O - - -         - - O - O - - -          - - - - - - - -
  6933. R * * * * - - - -         - - - * - - - -          O - - - - - - -
  6934.   - - - - O - - -         - - - * - - - -        R - - - - - - - -
  6935.   - - - - - - - -         - - - * - - - -          - - - - - - - -
  6936.   - - - - - - - -         - - - * - - - -          - - - - - - - -
  6937.   - - - - - - - -       R * * * * - - - -          - - - - - - - -
  6938.   - - - - - - - -         - - - - O - - -          - - - - - - - -
  6939.  
  6940. In the first example, the ray is deflected downwards by the upper
  6941. ball, then left by the lower ball, and finally retraces its path to
  6942. its point of origin.  The second example is similar.  The third
  6943. example is a bit anomalous but can be rationalized by realizing the
  6944. ray never gets a chance to get into the box.  Alternatively, the ray
  6945. can be thought of as being deflected downwards and immediately
  6946. emerging from the box.
  6947.  
  6948. A hit occurs when a ray runs straight into a ball:
  6949.  
  6950.   - - - - - - - -         - - - - - - - -          - - - - - - - -
  6951.   - - - - - - - -         - - - - - - - -          - - - - O - - -
  6952.   - - - - - - - -         - - - - O - - -        H * * * * - - - -
  6953.   - - - - - - - -       H * * * * O - - -          - - - * - - - -
  6954.   - - - - - - - -         - - - - O - - -          - - - O - - - -
  6955. H * * * O - - - -         - - - - - - - -          - - - - - - - -
  6956.   - - - - - - - -         - - - - - - - -          - - - - - - - -
  6957.   - - - - - - - -         - - - - - - - -          - - - - - - - -
  6958.  
  6959. Be sure to compare the second example of a hit with the first example of
  6960. a reflection.
  6961. Vbookmark-map
  6962. Keymap containing bindings to bookmark functions.
  6963. It is not bound to any key by default: to bind it
  6964. so that you have a bookmark prefix, just use `global-set-key' and bind a
  6965. key of your choice to `bookmark-map'.  All interactive bookmark
  6966. functions have a binding in this keymap.
  6967. Fbookmark-set
  6968. Set a bookmark named NAME inside a file.  
  6969. With prefix arg, will not overwrite a bookmark that has the same name
  6970. as NAME if such a bookmark already exists, but instead will "push"
  6971. the new bookmark onto the bookmark alist.  Thus the most recently set
  6972. bookmark with name NAME would be the one in effect at any given time,
  6973. but the others are still there, should you decide to delete the most
  6974. recent one.
  6975.  
  6976. To yank words from the text of the buffer and use them as part of the
  6977. bookmark name, type C-w while setting a bookmark.  Successive C-w's
  6978. yank successive words.
  6979.  
  6980. Typing C-v inserts the name of the current file being visited. Typing
  6981. C-u inserts the name of the last bookmark used in the buffer (as an
  6982. aid in using a single bookmark name to track your progress through a
  6983. large file).  If no bookmark was used, then C-u behaves like C-v and
  6984. inserts the name of the file being visited.
  6985.  
  6986. Use \[bookmark-delete] to remove bookmarks (you give it a name,
  6987. and it removes only the first instance of a bookmark with that name from
  6988. the list of bookmarks.)
  6989. Fbookmark-jump
  6990. Jump to bookmark BOOKMARK (a point in some file).  
  6991. You may have a problem using this function if the value of variable
  6992. `bookmark-alist' is nil.  If that happens, you need to load in some
  6993. bookmarks.  See help on function `bookmark-load' for more about
  6994. this.
  6995.  
  6996. If the file pointed to by BOOKMARK no longer exists, you will be asked
  6997. if you wish to give the bookmark a new location, and bookmark-jump
  6998. will then jump to the new location, as well as recording it in place
  6999. of the old one in the permanent bookmark record.
  7000. Fbookmark-relocate
  7001. Relocate BOOKMARK -- prompts for a filename, and makes an already
  7002. existing bookmark point to that file, instead of the one it used to
  7003. point at.  Useful when a file has been renamed after a bookmark was
  7004. set in it.
  7005. Fbookmark-locate
  7006. Insert the name of the file associated with BOOKMARK.
  7007. Optional second arg NO-INSERTION means merely return the filename as a
  7008. string.
  7009. Fbookmark-rename
  7010. Change the name of OLD-BOOKMARK to NEWNAME.  
  7011. If called from keyboard, prompts for OLD-BOOKMARK and NEWNAME.
  7012. If called from menubar, OLD-BOOKMARK is selected from a menu, and
  7013. prompts for NEWNAME. 
  7014. If called from Lisp, prompts for NEWNAME if only OLD-BOOKMARK was
  7015. passed as an argument.  If called with two strings, then no prompting
  7016. is done.  You must pass at least OLD-BOOKMARK when calling from Lisp.
  7017.  
  7018. While you are entering the new name, consecutive C-w's insert
  7019. consectutive words from the text of the buffer into the new bookmark
  7020. name, and C-v inserts the name of the file.
  7021. Fbookmark-insert
  7022. Insert the text of the file pointed to by bookmark BOOKMARK.  
  7023. You may have a problem using this function if the value of variable
  7024. `bookmark-alist' is nil.  If that happens, you need to load in some
  7025. bookmarks.  See help on function `bookmark-load' for more about
  7026. this.
  7027. Fbookmark-delete
  7028. Delete the bookmark named NAME from the bookmark list.  
  7029. Removes only the first instance of a bookmark with that name.  If
  7030. there are one or more other bookmarks with the same name, they will
  7031. not be deleted.  Defaults to the "current" bookmark (that is, the
  7032. one most recently used in this file, if any).
  7033. Fbookmark-write
  7034. Write bookmarks to a file (for which the user will be prompted
  7035. interactively).  Don't use this in Lisp programs; use bookmark-save
  7036. instead.
  7037. Fbookmark-save
  7038. Save currently defined bookmarks.
  7039. Saves by default in the file defined by the variable
  7040. `bookmark-file'.  With a prefix arg, save it in file FILE.
  7041.  
  7042. If you are calling this from Lisp, the two arguments are PREFIX-ARG
  7043. and FILE, and if you just want it to write to the default file, then
  7044. pass no arguments.  Or pass in nil and FILE, and it will save in FILE
  7045. instead.  If you pass in one argument, and it is non-nil, then the
  7046. user will be interactively queried for a file to save in.
  7047.  
  7048. When you want to load in the bookmarks from a file, use
  7049. `bookmark-load', \[bookmark-load].  That function will prompt you
  7050. for a file, defaulting to the file defined by variable
  7051. `bookmark-file'.
  7052. Fbookmark-load
  7053. Load bookmarks from FILE (which must be in bookmark format).
  7054. Appends loaded bookmarks to the front of the list of bookmarks.  If
  7055. optional second argument REVERT is non-nil, existing bookmarks are
  7056. destroyed.  Optional third arg NO-MSG means don't display any messages
  7057. while loading.
  7058.  
  7059. If you load a file that doesn't contain a proper bookmark alist, you
  7060. will corrupt Emacs's bookmark list.  Generally, you should only load
  7061. in files that were created with the bookmark functions in the first
  7062. place.  Your own personal bookmark file, `~/.emacs-bkmrks', is
  7063. maintained automatically by Emacs; you shouldn't need to load it
  7064. explicitly.
  7065. Flist-bookmarks
  7066. Display a list of existing bookmarks.
  7067. The list is displayed in a buffer named `*Bookmark List*'.
  7068. The leftmost column displays a D if the bookmark is flagged for
  7069. deletion, or > if it is flagged for displaying.
  7070. Fbyte-recompile-directory
  7071. Recompile every `.el' file in DIRECTORY that needs recompilation.
  7072. This is if a `.elc' file exists but is older than the `.el' file.
  7073. Files in subdirectories of DIRECTORY are processed also.
  7074.  
  7075. If the `.elc' file does not exist, normally the `.el' file is *not* compiled.
  7076. But a prefix argument (optional second arg) means ask user,
  7077. for each such `.el' file, whether to compile it.  Prefix argument 0 means
  7078. don't ask and compile the file anyway.
  7079.  
  7080. A nonzero prefix argument also means ask about each subdirectory.
  7081. Fbyte-compile-file
  7082. Compile a file of Lisp code named FILENAME into a file of byte code.
  7083. The output file's name is made by appending `c' to the end of FILENAME.
  7084. With prefix arg (noninteractively: 2nd arg), load the file after compiling.
  7085. Fcompile-defun
  7086. Compile and evaluate the current top-level form.
  7087. Print the result in the minibuffer.
  7088. With argument, insert value in current buffer after the form.
  7089. Fbyte-compile
  7090. If FORM is a symbol, byte-compile its function definition.
  7091. If FORM is a lambda or a macro, byte-compile it as a function.
  7092. Fdisplay-call-tree
  7093. Display a call graph of a specified file.
  7094. This lists which functions have been called, what functions called
  7095. them, and what functions they call.  The list includes all functions
  7096. whose definitions have been compiled in this Emacs session, as well as
  7097. all functions called by those functions.
  7098.  
  7099. The call graph does not include macros, inline functions, or
  7100. primitives that the byte-code interpreter knows about directly (eq,
  7101. cons, etc.).
  7102.  
  7103. The call tree also lists those functions which are not known to be called
  7104. (that is, to which no calls have been compiled), and which cannot be
  7105. invoked interactively.
  7106. Fbatch-byte-compile
  7107. Run `byte-compile-file' on the files remaining on the command line.
  7108. Use this from the command line, with `-batch';
  7109. it won't work in an interactive Emacs.
  7110. Each file is processed even if an error occurred previously.
  7111. For example, invoke "emacs -batch -f batch-byte-compile $emacs/ ~/*.el"
  7112. Vcalendar-week-start-day
  7113. *The day of the week on which a week in the calendar begins.
  7114. 0 means Sunday (default), 1 means Monday, and so on.
  7115. Vview-diary-entries-initially
  7116. *If t, the diary entries for the current date will be displayed on entry.
  7117. The diary is displayed in another window when the calendar is first displayed,
  7118. if the current date is visible.  The number of days of diary entries displayed
  7119. is governed by the variable `number-of-diary-entries'.
  7120. Vnumber-of-diary-entries
  7121. *Specifies how many days of diary entries are to be displayed initially.
  7122. This variable affects the diary display when the command M-x diary is used,
  7123. or if the value of the variable `view-diary-entries-initially' is t.  For
  7124. example, if the default value 1 is used, then only the current day's diary
  7125. entries will be displayed.  If the value 2 is used, then both the current
  7126. day's and the next day's entries will be displayed.  The value can also be
  7127. a vector such as [0 2 2 2 2 4 1]; this value will cause no diary entries to
  7128. be displayed on Sunday, the current date's and the next day's diary entries
  7129. to be displayed Monday through Thursday, Friday through Monday's entries to
  7130. be displayed on Friday, and only Saturday's entries to be displayed on
  7131. Saturday.  This variable does not affect the diary display with the `d'
  7132. command from the calendar; in that case, the prefix argument controls the
  7133. number of days of diary entries displayed.
  7134. Vmark-diary-entries-in-calendar
  7135. *If t, dates with diary entries will be marked in the calendar window.
  7136. The marking symbol is specified by the variable `diary-entry-marker'.
  7137. Vdiary-entry-marker
  7138. *The symbol used to mark dates that have diary entries.
  7139. Vview-calendar-holidays-initially
  7140. *If t, holidays for current three month period will be displayed on entry.
  7141. The holidays are displayed in another window when the calendar is first
  7142. displayed.
  7143. Vmark-holidays-in-calendar
  7144. *If t, dates of holidays will be marked in the calendar window.
  7145. The marking symbol is specified by the variable `calendar-holiday-marker'.
  7146. Vcalendar-holiday-marker
  7147. *The symbol used to mark notable dates in the calendar.
  7148. Vall-hebrew-calendar-holidays
  7149. *If nil, show only major holidays from the Hebrew calendar.
  7150.  
  7151. If nil, the only holidays from the Hebrew calendar shown will be those days of
  7152. such major interest as to appear on secular calendars.
  7153.  
  7154. If t, the holidays shown in the calendar will include all special days that
  7155. would be shown on a complete Hebrew calendar.
  7156. Vall-christian-calendar-holidays
  7157. *If nil, show only major holidays from the Christian calendar.
  7158.  
  7159. If nil, the only holidays from the Christian calendar shown will be those days
  7160. of such major interest as to appear on secular calendars.
  7161.  
  7162. If t, the holidays shown in the calendar will include all special days that
  7163. would be shown on a complete Christian calendar.
  7164. Vall-islamic-calendar-holidays
  7165. *If nil, show only major holidays from the Islamic calendar.
  7166.  
  7167. If nil, the only holidays from the Islamic calendar shown will be those days
  7168. of such major interest as to appear on secular calendars.
  7169.  
  7170. If t, the holidays shown in the calendar will include all special days that
  7171. would be shown on a complete Islamic calendar.
  7172. Vcalendar-load-hook
  7173. *List of functions to be called after the calendar is first loaded.
  7174. This is the place to add key bindings to calendar-mode-map.
  7175. Vinitial-calendar-window-hook
  7176. *List of functions to be called when the calendar window is first opened.
  7177. The functions invoked are called after the calendar window is opened, but
  7178. once opened is never called again.  Leaving the calendar with the `q' command
  7179. and reentering it will cause these functions to be called again.
  7180. Vtoday-visible-calendar-hook
  7181. *List of functions called whenever the current date is visible.
  7182. This can be used, for example, to replace today's date with asterisks; a
  7183. function `calendar-star-date' is included for this purpose:
  7184.     (setq today-visible-calendar-hook 'calendar-star-date)
  7185. It could also be used to mark the current date with `='; a function is also
  7186. provided for this:
  7187.     (setq today-visible-calendar-hook 'calendar-mark-today)
  7188.  
  7189. The corresponding variable `today-invisible-calendar-hook' is the list of
  7190. functions called when the calendar function was called when the current
  7191. date is not visible in the window.
  7192.  
  7193. Other than the use of the provided functions, the changing of any
  7194. characters in the calendar buffer by the hooks may cause the failure of the
  7195. functions that move by days and weeks.
  7196. Vtoday-invisible-calendar-hook
  7197. *List of functions called whenever the current date is not visible.
  7198.  
  7199. The corresponding variable `today-visible-calendar-hook' is the list of
  7200. functions called when the calendar function was called when the current
  7201. date is visible in the window.
  7202.  
  7203. Other than the use of the provided functions, the changing of any
  7204. characters in the calendar buffer by the hooks may cause the failure of the
  7205. functions that move by days and weeks.
  7206. Vdiary-file
  7207. *Name of the file in which one's personal diary of dates is kept.
  7208.  
  7209. The file's entries are lines in any of the forms
  7210.  
  7211.             MONTH/DAY
  7212.             MONTH/DAY/YEAR
  7213.             MONTHNAME DAY
  7214.             MONTHNAME DAY, YEAR
  7215.             DAYNAME
  7216.  
  7217. at the beginning of the line; the remainder of the line is the diary entry
  7218. string for that date.  MONTH and DAY are one or two digit numbers, YEAR is
  7219. a number and may be written in full or abbreviated to the final two digits.
  7220. If the date does not contain a year, it is generic and applies to any year.
  7221. DAYNAME entries apply to any date on which is on that day of the week.
  7222. MONTHNAME and DAYNAME can be spelled in full, abbreviated to three
  7223. characters (with or without a period), capitalized or not.  Any of DAY,
  7224. MONTH, or MONTHNAME, YEAR can be `*' which matches any day, month, or year,
  7225. respectively.
  7226.  
  7227. The European style (in which the day precedes the month) can be used
  7228. instead, if you execute `european-calendar' when in the calendar, or set
  7229. `european-calendar-style' to t in your .emacs file.  The European forms are
  7230.  
  7231.             DAY/MONTH
  7232.             DAY/MONTH/YEAR
  7233.             DAY MONTHNAME
  7234.             DAY MONTHNAME YEAR
  7235.             DAYNAME
  7236.  
  7237. To revert to the default American style from the European style, execute
  7238. `american-calendar' in the calendar.
  7239.  
  7240. A diary entry can be preceded by a diary-nonmarking-symbol (ordinarily `&')
  7241. to make that entry nonmarking--that is, it will not be marked on dates in
  7242. the calendar window but will appear in a diary window.
  7243.  
  7244. Multiline diary entries are made by indenting lines after the first with
  7245. either a TAB or one or more spaces.
  7246.  
  7247. Lines not in one the above formats are ignored.  Here are some sample diary
  7248. entries (in the default American style):
  7249.  
  7250.      12/22/1988 Twentieth wedding anniversary!!
  7251.      &1/1. Happy New Year!
  7252.      10/22 Ruth's birthday.
  7253.      21: Payday
  7254.      Tuesday--weekly meeting with grad students at 10am
  7255.               Supowit, Shen, Bitner, and Kapoor to attend.
  7256.      1/13/89 Friday the thirteenth!!
  7257.      &thu 4pm squash game with Lloyd.
  7258.      mar 16 Dad's birthday
  7259.      April 15, 1989 Income tax due.
  7260.      &* 15 time cards due.
  7261.  
  7262. If the first line of a diary entry consists only of the date or day name with
  7263. no trailing blanks or punctuation, then that line will not be displayed in the
  7264. diary window; only the continuation lines will be shown.  For example, the
  7265. single diary entry
  7266.  
  7267.      02/11/1989
  7268.       Bill Blattner visits Princeton today
  7269.       2pm Cognitive Studies Committee meeting
  7270.       2:30-5:30 Lizzie at Lawrenceville for `Group Initiative'
  7271.       4:00pm Jamie Tappenden
  7272.       7:30pm Dinner at George and Ed's for Alan Ryan
  7273.       7:30-10:00pm dance at Stewart Country Day School
  7274.  
  7275. will appear in the diary window without the date line at the beginning.  This
  7276. facility allows the diary window to look neater, but can cause confusion if
  7277. used with more than one day's entries displayed.
  7278.  
  7279. Diary entries can be based on Lisp sexps.  For example, the diary entry
  7280.  
  7281.       %%(diary-block 11 1 1990 11 10 1990) Vacation
  7282.  
  7283. causes the diary entry "Vacation" to appear from November 1 through November
  7284. 10, 1990.  Other functions available are `diary-float', `diary-anniversary',
  7285. `diary-cyclic', `diary-day-of-year', `diary-iso-date', `diary-french-date',
  7286. `diary-hebrew-date', `diary-islamic-date', `diary-mayan-date',
  7287. `diary-yahrzeit', `diary-sunrise-sunset', `diary-phases-of-moon',
  7288. `diary-parasha', `diary-omer', `diary-rosh-hodesh', and
  7289. `diary-sabbath-candles'.  See the documentation for the function
  7290. `list-sexp-diary-entries' for more details.
  7291.  
  7292. Diary entries based on the Hebrew and/or the Islamic calendar are also
  7293. possible, but because these are somewhat slow, they are ignored
  7294. unless you set the `nongregorian-diary-listing-hook' and the
  7295. `nongregorian-diary-marking-hook' appropriately.  See the documentation
  7296. for these functions for details.
  7297.  
  7298. Diary files can contain directives to include the contents of other files; for
  7299. details, see the documentation for the variable `list-diary-entries-hook'.
  7300. Vdiary-nonmarking-symbol
  7301. *Symbol indicating that a diary entry is not to be marked in the calendar.
  7302. Vhebrew-diary-entry-symbol
  7303. *Symbol indicating a diary entry according to the Hebrew calendar.
  7304. Vislamic-diary-entry-symbol
  7305. *Symbol indicating a diary entry according to the Islamic calendar.
  7306. Vdiary-include-string
  7307. *The string indicating inclusion of another file of diary entries.
  7308. See the documentation for the function `include-other-diary-files'.
  7309. Vsexp-diary-entry-symbol
  7310. *The string used to indicate a sexp diary entry in diary-file.
  7311. See the documentation for the function `list-sexp-diary-entries'.
  7312. Vabbreviated-calendar-year
  7313. *Interpret a two-digit year DD in a diary entry as either 19DD or 20DD.
  7314. For the Gregorian calendar; similarly for the Hebrew and Islamic calendars.
  7315. If this variable is nil, years must be written in full.
  7316. Veuropean-calendar-style
  7317. *Use the European style of dates in the diary and in any displays.
  7318. If this variable is t, a date 1/2/1990 would be interpreted as February 1,
  7319. 1990.  The accepted European date styles are
  7320.  
  7321.             DAY/MONTH
  7322.             DAY/MONTH/YEAR
  7323.             DAY MONTHNAME
  7324.             DAY MONTHNAME YEAR
  7325.             DAYNAME
  7326.  
  7327. Names can be capitalized or not, written in full, or abbreviated to three
  7328. characters with or without a period.
  7329. Vamerican-date-diary-pattern
  7330. *List of pseudo-patterns describing the American patterns of date used.
  7331. See the documentation of diary-date-forms for an explanation.
  7332. Veuropean-date-diary-pattern
  7333. *List of pseudo-patterns describing the European patterns of date used.
  7334. See the documentation of diary-date-forms for an explanation.
  7335. Veuropean-calendar-display-form
  7336. *Pseudo-pattern governing the way a date appears in the European style.
  7337. See the documentation of calendar-date-display-form for an explanation.
  7338. Vamerican-calendar-display-form
  7339. *Pseudo-pattern governing the way a date appears in the American style.
  7340. See the documentation of calendar-date-display-form for an explanation.
  7341. Vprint-diary-entries-hook
  7342. *List of functions called after a temporary diary buffer is prepared.
  7343. The buffer shows only the diary entries currently visible in the diary
  7344. buffer.  The default just does the printing.  Other uses might include, for
  7345. example, rearranging the lines into order by day and time, saving the buffer
  7346. instead of deleting it, or changing the function used to do the printing.
  7347. Vlist-diary-entries-hook
  7348. *List of functions called after diary file is culled for relevant entries.
  7349. It is to be used for diary entries that are not found in the diary file.
  7350.  
  7351. A function `include-other-diary-files' is provided for use as the value of
  7352. this hook.  This function enables you to use shared diary files together
  7353. with your own.  The files included are specified in the diary-file by lines
  7354. of the form
  7355.  
  7356.         #include "filename"
  7357.  
  7358. This is recursive; that is, #include directives in files thus included are
  7359. obeyed.  You can change the "#include" to some other string by changing
  7360. the variable `diary-include-string'.  When you use `include-other-diary-files'
  7361. as part of the list-diary-entries-hook, you will probably also want to use the
  7362. function `mark-included-diary-files' as part of the mark-diary-entries-hook.
  7363.  
  7364. For example, you could use
  7365.  
  7366.      (setq list-diary-entries-hook
  7367.        '(include-other-diary-files sort-diary-entries))
  7368.      (setq diary-display-hook 'fancy-diary-display)
  7369.  
  7370. in your .emacs file to cause the fancy diary buffer to be displayed with
  7371. diary entries from various included files, each day's entries sorted into
  7372. lexicographic order.
  7373. Vdiary-hook
  7374. *List of functions called after the display of the diary.
  7375. Can be used for appointment notification.
  7376. Vdiary-display-hook
  7377. *List of functions that handle the display of the diary.
  7378. If nil (the default), `simple-diary-display' will be used.  Use `ignore' for no
  7379. diary display.
  7380.  
  7381. Ordinarily, this just displays the diary buffer (with holidays indicated in
  7382. the mode line), if there are any relevant entries.  At the time these
  7383. functions are called, the variable `diary-entries-list' is a list, in order
  7384. by date, of all relevant diary entries in the form of ((MONTH DAY YEAR)
  7385. STRING), where string is the diary entry for the given date.  This can be
  7386. used, for example, a different buffer for display (perhaps combined with
  7387. holidays), or produce hard copy output.
  7388.  
  7389. A function `fancy-diary-display' is provided as an alternative
  7390. choice for this hook; this function prepares a special noneditable diary
  7391. buffer with the relevant diary entries that has neat day-by-day arrangement
  7392. with headings.  The fancy diary buffer will show the holidays unless the
  7393. variable `holidays-in-diary-buffer' is set to nil.  Ordinarily, the fancy
  7394. diary buffer will not show days for which there are no diary entries, even
  7395. if that day is a holiday; if you want such days to be shown in the fancy
  7396. diary buffer, set the variable `diary-list-include-blanks' to t.
  7397. Vnongregorian-diary-listing-hook
  7398. *List of functions called for listing diary file and included files.
  7399. As the files are processed for diary entries, these functions are used to cull
  7400. relevant entries.  You can use either or both of `list-hebrew-diary-entries'
  7401. and `list-islamic-diary-entries'.  The documentation for these functions
  7402. describes the style of such diary entries.
  7403. Vmark-diary-entries-hook
  7404. *List of functions called after marking diary entries in the calendar.
  7405.  
  7406. A function `mark-included-diary-files' is also provided for use as the
  7407. mark-diary-entries-hook; it enables you to use shared diary files together
  7408. with your own.  The files included are specified in the diary-file by lines
  7409. of the form
  7410.         #include "filename"
  7411. This is recursive; that is, #include directives in files thus included are
  7412. obeyed.  You can change the "#include" to some other string by changing the
  7413. variable `diary-include-string'.  When you use `mark-included-diary-files' as
  7414. part of the mark-diary-entries-hook, you will probably also want to use the
  7415. function `include-other-diary-files' as part of the list-diary-entries-hook.
  7416. Vnongregorian-diary-marking-hook
  7417. *List of functions called for marking diary file and included files.
  7418. As the files are processed for diary entries, these functions are used to cull
  7419. relevant entries.  You can use either or both of `mark-hebrew-diary-entries'
  7420. and `mark-islamic-diary-entries'.  The documentation for these functions
  7421. describes the style of such diary entries.
  7422. Vdiary-list-include-blanks
  7423. *If nil, do not include days with no diary entry in the list of diary entries.
  7424. Such days will then not be shown in the the fancy diary buffer, even if they
  7425. are holidays.
  7426. Vholidays-in-diary-buffer
  7427. *If t, the holidays will be indicated in the diary display.
  7428. The holidays will be given in the mode line of the diary buffer, or in the
  7429. fancy diary buffer next to the date.  This slows down the diary functions
  7430. somewhat; setting it to nil will make the diary display faster.
  7431. Vgeneral-holidays
  7432. *General holidays.  Default value is for the United States.
  7433. See the documentation for `calendar-holidays' for details.
  7434. Vlocal-holidays
  7435. *Local holidays.
  7436. See the documentation for `calendar-holidays' for details.
  7437. Vother-holidays
  7438. *User defined holidays.
  7439. See the documentation for `calendar-holidays' for details.
  7440. Vhebrew-holidays
  7441. *Jewish holidays.
  7442. See the documentation for `calendar-holidays' for details.
  7443. Vchristian-holidays
  7444. *Christian holidays.
  7445. See the documentation for `calendar-holidays' for details.
  7446. Vislamic-holidays
  7447. *Islamic holidays.
  7448. See the documentation for `calendar-holidays' for details.
  7449. Vsolar-holidays
  7450. *Sun-related holidays.
  7451. See the documentation for `calendar-holidays' for details.
  7452. Fcalendar
  7453. Display a three-month calendar in another window.
  7454. The three months appear side by side, with the current month in the middle
  7455. surrounded by the previous and next months.  The cursor is put on today's date.
  7456.  
  7457. If called with an optional prefix argument, prompts for month and year.
  7458.  
  7459. This function is suitable for execution in a .emacs file; appropriate setting
  7460. of the variable `view-diary-entries-initially' will cause the diary entries for
  7461. the current date to be displayed in another window.  The value of the variable
  7462. `number-of-diary-entries' controls the number of days of diary entries
  7463. displayed upon initial display of the calendar.
  7464.  
  7465. An optional prefix argument ARG causes the calendar displayed to be ARG
  7466. months in the future if ARG is positive or in the past if ARG is negative;
  7467. in this case the cursor goes on the first day of the month.
  7468.  
  7469. Once in the calendar window, future or past months can be moved into view.
  7470. Arbitrary months can be displayed, or the calendar can be scrolled forward
  7471. or backward.
  7472.  
  7473. The cursor can be moved forward or backward by one day, one week, one month,
  7474. or one year.  All of these commands take prefix arguments which, when negative,
  7475. cause movement in the opposite direction.  For convenience, the digit keys
  7476. and the minus sign are automatically prefixes.  The window is replotted as
  7477. necessary to display the desired date.
  7478.  
  7479. Diary entries can be marked on the calendar or displayed in another window.
  7480.  
  7481. Use M-x describe-mode for details of the key bindings in the calendar window.
  7482.  
  7483. The Gregorian calendar is assumed.
  7484.  
  7485. After loading the calendar, the hooks given by the variable
  7486. `calendar-load-hook' are run.  This the place to add key bindings to the
  7487. calendar-mode-map.
  7488.  
  7489. After preparing the calendar window initially, the hooks given by the variable
  7490. `initial-calendar-window-hook' are run.
  7491.  
  7492. The hooks given by the variable `today-visible-calendar-hook' are run
  7493. everytime the calendar window gets scrolled, if the current date is visible
  7494. in the window.  If it is not visible, the hooks given by the variable
  7495. `today-invisible-calendar-hook' are run.  Thus, for example, setting
  7496. `today-visible-calendar-hook' to 'calendar-star-date will cause today's date
  7497. to be replaced by asterisks to highlight it whenever it is in the window.
  7498. Flist-yahrzeit-dates
  7499. List Yahrzeit dates for *Gregorian* DEATH-DATE from START-YEAR to END-YEAR.
  7500. When called interactively from the calendar window, the date of death is taken
  7501. from the cursor position.
  7502. Fdescribe-buffer-case-table
  7503. Describe the case table of the current buffer.
  7504. Fset-case-syntax-delims
  7505. Make characters L and R a matching pair of non-case-converting delimiters.
  7506. This sets the entries for L and R in TABLE, which is a string
  7507. that will be used as the downcase part of a case table.
  7508. It also modifies `standard-syntax-table', and `text-mode-syntax-table' to
  7509. indicate left and right delimiters.
  7510. Fset-case-syntax-pair
  7511. Make characters UC and LC a pair of inter-case-converting letters.
  7512. This sets the entries for characters UC and LC in TABLE, which is a string
  7513. that will be used as the downcase part of a case table.
  7514. It also modifies `standard-syntax-table' and `text-mode-syntax-table'
  7515. to indicate an (uppercase, lowercase) pair of letters.
  7516. Fset-case-syntax
  7517. Make characters C case-invariant with syntax SYNTAX.
  7518. This sets the entries for character C in TABLE, which is a string
  7519. that will be used as the downcase part of a case table.
  7520. It also modifies `standard-syntax-table' and `text-mode-syntax-table'.
  7521. SYNTAX should be " ", "w", "." or "_".
  7522. Frepeat-matching-complex-command
  7523. Edit and re-evaluate complex command with name matching PATTERN.
  7524. Matching occurrences are displayed, most recent first, until you select
  7525. a form for evaluation.  If PATTERN is empty (or nil), every form in the
  7526. command history is offered.  The form is placed in the minibuffer for
  7527. editing and the result is evaluated.
  7528. Flist-command-history
  7529. List history of commands typed to minibuffer.
  7530. The number of commands listed is controlled by `list-command-history-max'.
  7531. Calls value of `list-command-history-filter' (if non-nil) on each history
  7532. element to judge if that element should be excluded from the list.
  7533.  
  7534. The buffer is left in Command History mode.
  7535. Fcommand-history-mode
  7536. Major mode for examining commands from `command-history'.
  7537. The number of commands listed is controlled by `list-command-history-max'.
  7538. The command history is filtered by `list-command-history-filter' if non-nil.
  7539. Use \<command-history-map>\[command-history-repeat] to repeat the command on the current line.
  7540.  
  7541. Otherwise much like Emacs-Lisp Mode except that there is no self-insertion
  7542. and digits provide prefix arguments.  Tab does not indent.
  7543. \{command-history-map}
  7544. Calls the value of `command-history-hook' if that is non-nil.
  7545. The Command History listing is recomputed each time this mode is invoked.
  7546. Fmake-comint
  7547. Make a comint process NAME in a buffer, running PROGRAM.
  7548. The name of the buffer is made by surrounding NAME with `*'s.
  7549. If there is already a running process in that buffer, it is not restarted.
  7550. Optional third arg STARTFILE is the name of a file to send the contents of to 
  7551. the process.  Any more args are arguments to PROGRAM.
  7552. Fcompare-windows
  7553. Compare text in current window with text in next window.
  7554. Compares the text starting at point in each window,
  7555. moving over text in each one as far as they match.
  7556.  
  7557. A prefix arg means ignore changes in whitespace.
  7558. The variable `compare-windows-whitespace' controls how whitespace is skipped.
  7559. If `compare-ignore-case' is non-nil, changes in case are also ignored.
  7560. Vcompilation-mode-hook
  7561. *List of hook functions run by `compilation-mode' (see `run-hooks').
  7562. Vcompilation-window-height
  7563. *Number of lines in a compilation window.  If nil, use Emacs default.
  7564. Vcompilation-buffer-name-function
  7565. Function to compute the name of a compilation buffer.
  7566. The function receives one argument, the name of the major mode of the
  7567. compilation buffer.  It should return a string.
  7568. nil means compute the name with `(concat "*" (downcase major-mode) "*")'.
  7569. Vcompilation-finish-function
  7570. *Function to call when a compilation process finishes.
  7571. It is called with two arguments: the compilation buffer, and a string
  7572. describing how the process finished.
  7573. Vcompilation-search-path
  7574. *List of directories to search for source files named in error messages.
  7575. Elements should be directory names, not file names of directories.
  7576. nil as an element means to try the default directory.
  7577. Fcompile
  7578. Compile the program including the current buffer.  Default: run `make'.
  7579. Runs COMMAND, a shell command, in a separate process asynchronously
  7580. with output going to the buffer `*compilation*'.
  7581.  
  7582. You can then use the command \[next-error] to find the next error message
  7583. and move to the source code that caused it.
  7584.  
  7585. To run more than one compilation at once, start one and rename the
  7586. `*compilation*' buffer to some other name with \[rename-buffer].
  7587. Then start the next one.
  7588.  
  7589. The name used for the buffer is actually whatever is returned by
  7590. the function in `compilation-buffer-name-function', so you can set that
  7591. to a function that generates a unique name.
  7592. Fgrep
  7593. Run grep, with user-specified args, and collect output in a buffer.
  7594. While grep runs asynchronously, you can use the \[next-error] command
  7595. to find the text that grep hits refer to.
  7596.  
  7597. This command uses a special history list for its arguments, so you can
  7598. easily repeat a grep command.
  7599. Fcompilation-minor-mode
  7600. Toggle compilation minor mode.
  7601. With arg, turn compilation mode on if and only if arg is positive.
  7602. See `compilation-mode'.
  7603. Fnext-error
  7604. Visit next compilation error message and corresponding source code.
  7605. This operates on the output from the \[compile] command.
  7606. If all preparsed error messages have been processed,
  7607. the error message buffer is checked for new ones.
  7608.  
  7609. A prefix arg specifies how many error messages to move;
  7610. negative means move back to previous error messages.
  7611. Just C-u as a prefix means reparse the error message buffer
  7612. and start at the first error.
  7613.  
  7614. \[next-error] normally applies to the most recent compilation started,
  7615. but as long as you are in the middle of parsing errors from one compilation
  7616. output buffer, you stay with that compilation output buffer.
  7617.  
  7618. Use \[next-error] in a compilation output buffer to switch to
  7619. processing errors from that compilation.
  7620.  
  7621. See variables `compilation-parse-errors-function' and
  7622. `compilation-error-regexp-alist' for customization ideas.
  7623. Fcookie
  7624. Return a random phrase from PHRASE-FILE.  When the phrase file
  7625. is read in, display STARTMSG at beginning of load, ENDMSG at end.
  7626. Fcookie-insert
  7627. Insert random phrases from PHRASE-FILE; COUNT of them.  When the phrase file
  7628. is read in, display STARTMSG at beginning of load, ENDMSG at end.
  7629. Fcookie-snarf
  7630. Reads in the PHRASE-FILE, returns it as a vector of strings.  Emit
  7631. STARTMSG and ENDMSG before and after.  Caches the result; second and
  7632. subsequent calls on the same file won't go to disk.
  7633. Fshuffle-vector
  7634. Randomly permute the elements of VECTOR (all permutations equally likely)
  7635. Fc++-mode
  7636. Major mode for editing C++ code.  Very much like editing C code.
  7637. Expression and list commands understand all C++ brackets.
  7638. Tab at left margin indents for C++ code
  7639. Comments are delimited with /* ... */ {or with // ... <newline>}
  7640. Paragraphs are separated by blank lines only.
  7641. Delete converts tabs to spaces as it moves back.
  7642. \{c++-mode-map}
  7643. Variables controlling indentation style:
  7644.  c-tab-always-indent
  7645.     Non-nil means TAB in C mode should always reindent the current line,
  7646.     regardless of where in the line point is when the TAB command is used.
  7647.     Default is t.
  7648.  c-auto-newline
  7649.     Non-nil means automatically newline before and after braces,
  7650.     and after colons and semicolons, inserted in C code.
  7651.  c-indent-level
  7652.     Indentation of C statements within surrounding block.
  7653.     The surrounding block's indentation is the indentation
  7654.     of the line on which the open-brace appears.
  7655.  c-continued-statement-offset
  7656.     Extra indentation given to a substatement, such as the
  7657.     then-clause of an if or body of a while.
  7658.  c-continued-brace-offset
  7659.     Extra indentation given to a brace that starts a substatement.
  7660.     This is in addition to c-continued-statement-offset.
  7661.  c-brace-offset
  7662.     Extra indentation for line if it starts with an open brace.
  7663.  c-brace-imaginary-offset
  7664.     An open brace following other text is treated as if it were
  7665.     this far to the right of the start of its line.
  7666.  c-argdecl-indent
  7667.     Indentation level of declarations of C function arguments.
  7668.  c-label-offset
  7669.     Extra indentation for line that is a label, or case or ``default:'', or
  7670.     ``public:'' or ``private:'', or ``protected:''.
  7671.  c++-electric-colon
  7672.     If non-nil at invocation of c++-mode (t is the default) colon electricly
  7673.     indents.
  7674.  c++-empty-arglist-indent
  7675.     If non-nil, a function declaration or invocation which ends a line with a
  7676.     left paren is indented this many extra spaces, instead of flush with the
  7677.     left paren.
  7678.  c++-friend-offset
  7679.     Offset of C++ friend class declarations relative to member declarations.
  7680.  c++-member-init-indent
  7681.     Indentation level of member initializations in function declarations,
  7682.     if they are on a separate line beginning with a colon.
  7683.  c++-continued-member-init-offset
  7684.     Extra indentation for continuation lines of member initializations; NIL
  7685.     means to align with previous initializations rather than with the colon.
  7686.  
  7687. Settings for K&R, BSD, and Stroustrup indentation styles are
  7688.   c-indent-level                5    8    4
  7689.   c-continued-statement-offset  5    8    4
  7690.   c-continued-brace-offset                0
  7691.   c-brace-offset               -5   -8    0
  7692.   c-brace-imaginary-offset                0
  7693.   c-argdecl-indent              0    8    4
  7694.   c-label-offset               -5   -8   -4
  7695.   c++-empty-arglist-indent                4
  7696.   c++-friend-offset                       0
  7697.  
  7698. Turning on C++ mode calls the value of the variable `c++-mode-hook' with
  7699. no args if that value is non-nil.
  7700. Fdabbrev-expand
  7701. Expand previous word "dynamically".
  7702. Expands to the most recent, preceding word for which this is a prefix.
  7703. If no suitable preceding word is found, words following point are considered.
  7704.  
  7705. If `case-fold-search' and `case-replace' are non-nil (usually true)
  7706. then the substituted word may be case-adjusted to match the abbreviation
  7707. that you had typed.  This takes place if the substituted word, as found,
  7708. is all lower case, or if it is at the beginning of a sentence and only
  7709. its first letter was upper case.
  7710.  
  7711. A positive prefix arg N says to take the Nth backward DISTINCT
  7712. possibility.  A negative argument says search forward.  The variable
  7713. `dabbrev-backward-only' may be used to limit the direction of search to
  7714. backward if set non-nil.
  7715.  
  7716. If the cursor has not moved from the end of the previous expansion and
  7717. no argument is given, replace the previously-made expansion
  7718. with the next possible expansion not yet tried.
  7719. Fdebug
  7720. Enter debugger.  Returns if user says "continue".
  7721. Arguments are mainly for use when this is called from the internals
  7722. of the evaluator.
  7723.  
  7724. You may call with no args, or you may pass nil as the first arg and
  7725. any other args you like.  In that case, the list of args after the
  7726. first will be printed into the backtrace buffer.
  7727. Fdebug-on-entry
  7728. Request FUNCTION to invoke debugger each time it is called.
  7729. If the user continues, FUNCTION's execution proceeds.
  7730. Works by modifying the definition of FUNCTION,
  7731. which must be written in Lisp, not predefined.
  7732. Use \[cancel-debug-on-entry] to cancel the effect of this command.
  7733. Redefining FUNCTION also does that.
  7734. Fcancel-debug-on-entry
  7735. Undo effect of \[debug-on-entry] on FUNCTION.
  7736. If argument is nil or an empty string, cancel for all functions.
  7737. Fdelete-selection-mode
  7738. Toggle Delete Selection mode.
  7739. When ON, typed text replaces the selection if the selection is active.
  7740. When OFF, typed text is just inserted at point.
  7741. Fdiary
  7742. Generate the diary window for ARG days starting with the current date.
  7743. If no argument is provided, the number of days of diary entries is governed
  7744. by the variable `number-of-diary-entries'.  This function is suitable for
  7745. execution in a `.emacs' file.
  7746. Fdiff
  7747. Find and display the differences between OLD and NEW files.
  7748. Interactively the current buffer's file name is the default for for NEW
  7749. and a backup file for NEW is the default for OLD.
  7750. With prefix arg, prompt for diff switches.
  7751. Fdiff-backup
  7752. Diff this file with its backup file or vice versa.
  7753. Uses the latest backup, if there are several numerical backups.
  7754. If this file is a backup, diff it with its original.
  7755. The backup file is the first file given to `diff'.
  7756. Fdired-diff
  7757. Compare file at point with file FILE using `diff'.
  7758. FILE defaults to the file at the mark.
  7759. The prompted-for file is the first file given to `diff'.
  7760. With prefix arg, prompt for second argument SWITCHES,
  7761.  which is options for `diff'.
  7762. Fdired-backup-diff
  7763. Diff this file with its backup file or vice versa.
  7764. Uses the latest backup, if there are several numerical backups.
  7765. If this file is a backup, diff it with its original.
  7766. The backup file is the first file given to `diff'.
  7767. With prefix arg, prompt for argument SWITCHES which is options for `diff'.
  7768. Fdired-do-chmod
  7769. Change the mode of the marked (or next ARG) files.
  7770. This calls chmod, thus symbolic modes like `g+w' are allowed.
  7771. Fdired-do-chgrp
  7772. Change the group of the marked (or next ARG) files.
  7773. Fdired-do-chown
  7774. Change the owner of the marked (or next ARG) files.
  7775. Fdired-do-print
  7776. Print the marked (or next ARG) files.
  7777. Uses the shell command coming from variables `lpr-command' and
  7778. `lpr-switches' as default.
  7779. Fdired-do-shell-command
  7780. Run a shell command COMMAND on the marked files.
  7781. If no files are marked or a specific numeric prefix arg is given,
  7782. the next ARG files are used.  Just \[universal-argument] means the current file.
  7783. The prompt mentions the file(s) or the marker, as appropriate.
  7784.  
  7785. If there is output, it goes to a separate buffer.
  7786.  
  7787. Normally the command is run on each file individually.
  7788. However, if there is a `*' in the command then it is run
  7789. just once with the entire file list substituted there.
  7790.  
  7791. No automatic redisplay of dired buffers is attempted, as there's no
  7792. telling what files the command may have changed.  Type
  7793. \[dired-do-redisplay] to redisplay the marked files.
  7794.  
  7795. The shell command has the top level directory as working directory, so
  7796. output files usually are created there instead of in a subdir.
  7797. Fdired-do-kill-lines
  7798. Kill all marked lines (not the files).
  7799. With a prefix argument, kill that many lines starting with the current line.
  7800. (A negative argument kills lines before the current line.)
  7801. To kill an entire subdirectory, go to its directory header line
  7802. and use this command with a prefix argument (the value does not matter).
  7803. Fdired-do-compress
  7804. Compress or uncompress marked (or next ARG) files.
  7805. Fdired-do-byte-compile
  7806. Byte compile marked (or next ARG) Emacs Lisp files.
  7807. Fdired-do-load
  7808. Load the marked (or next ARG) Emacs Lisp files.
  7809. Fdired-do-redisplay
  7810. Redisplay all marked (or next ARG) files.
  7811. If on a subdir line, redisplay that subdirectory.  In that case,
  7812. a prefix arg lets you edit the `ls' switches used for the new listing.
  7813. Fdired-string-replace-match
  7814. Replace first match of REGEXP in STRING with NEWTEXT.
  7815. If it does not match, nil is returned instead of the new string.
  7816. Optional arg LITERAL means to take NEWTEXT literally.
  7817. Optional arg GLOBAL means to replace all matches.
  7818. Fdired-create-directory
  7819. Create a directory called DIRECTORY.
  7820. Fdired-do-copy
  7821. Copy all marked (or next ARG) files, or copy the current file.
  7822. This normally preserves the last-modified date when copying.
  7823. When operating on just the current file, you specify the new name.
  7824. When operating on multiple or marked files, you specify a directory
  7825. and new symbolic links are made in that directory
  7826. with the same names that the files currently have.
  7827. Fdired-do-symlink
  7828. Make symbolic links to current file or all marked (or next ARG) files.
  7829. When operating on just the current file, you specify the new name.
  7830. When operating on multiple or marked files, you specify a directory
  7831. and new symbolic links are made in that directory
  7832. with the same names that the files currently have.
  7833. Fdired-do-hardlink
  7834. Add names (hard links) current file or all marked (or next ARG) files.
  7835. When operating on just the current file, you specify the new name.
  7836. When operating on multiple or marked files, you specify a directory
  7837. and new hard links are made in that directory
  7838. with the same names that the files currently have.
  7839. Fdired-do-rename
  7840. Rename current file or all marked (or next ARG) files.
  7841. When renaming just the current file, you specify the new name.
  7842. When renaming multiple or marked files, you specify a directory.
  7843. Fdired-do-rename-regexp
  7844. Rename marked files containing REGEXP to NEWNAME.
  7845. As each match is found, the user must type a character saying
  7846.   what to do with it.  For directions, type \[help-command] at that time.
  7847. NEWNAME may contain \=\<n> or \& as in `query-replace-regexp'.
  7848. REGEXP defaults to the last regexp used.
  7849. With a zero prefix arg, renaming by regexp affects the complete
  7850.   pathname - usually only the non-directory part of file names is used
  7851.   and changed.
  7852. Fdired-do-copy-regexp
  7853. Copy all marked files containing REGEXP to NEWNAME.
  7854. See function `dired-rename-regexp' for more info.
  7855. Fdired-do-hardlink-regexp
  7856. Hardlink all marked files containing REGEXP to NEWNAME.
  7857. See function `dired-rename-regexp' for more info.
  7858. Fdired-do-symlink-regexp
  7859. Symlink all marked files containing REGEXP to NEWNAME.
  7860. See function `dired-rename-regexp' for more info.
  7861. Fdired-upcase
  7862. Rename all marked (or next ARG) files to upper case.
  7863. Fdired-downcase
  7864. Rename all marked (or next ARG) files to lower case.
  7865. Fdired-maybe-insert-subdir
  7866. Insert this subdirectory into the same dired buffer.
  7867. If it is already present, just move to it (type \[dired-do-redisplay] to refresh),
  7868.   else inserts it at its natural place (as `ls -lR' would have done).
  7869. With a prefix arg, you may edit the ls switches used for this listing.
  7870.   You can add `R' to the switches to expand the whole tree starting at
  7871.   this subdirectory.
  7872. This function takes some pains to conform to `ls -lR' output.
  7873. Fdired-prev-subdir
  7874. Go to previous subdirectory, regardless of level.
  7875. When called interactively and not on a subdir line, go to this subdir's line.
  7876. Fdired-goto-subdir
  7877. Go to end of header line of DIR in this dired buffer.
  7878. Return value of point on success, otherwise return nil.
  7879. The next char is either \n, or \r if DIR is hidden.
  7880. Fdired-mark-subdir-files
  7881. Mark all files except `.' and `..'.
  7882. Fdired-kill-subdir
  7883. Remove all lines of current subdirectory.
  7884. Lower levels are unaffected.
  7885. Fdired-tree-up
  7886. Go up ARG levels in the dired tree.
  7887. Fdired-tree-down
  7888. Go down in the dired tree.
  7889. Fdired-hide-subdir
  7890. Hide or unhide the current subdirectory and move to next directory.
  7891. Optional prefix arg is a repeat factor.
  7892. Use \[dired-hide-all] to (un)hide all directories.
  7893. Fdired-hide-all
  7894. Hide all subdirectories, leaving only their header lines.
  7895. If there is already something hidden, make everything visible again.
  7896. Use \[dired-hide-subdir] to (un)hide a particular subdirectory.
  7897. Vdired-listing-switches
  7898. *Switches passed to `ls' for dired.  MUST contain the `l' option.
  7899. May contain all other options that don't contradict `-l';
  7900. may contain even `F', `b', `i' and `s'.
  7901. Vdired-chown-program
  7902. Name of chown command (usually `chown' or `/etc/chown').
  7903. Vdired-ls-F-marks-symlinks
  7904. *Informs dired about how `ls -lF' marks symbolic links.
  7905. Set this to t if `insert-directory-program' with `-lF' marks the symbolic link
  7906. itself with a trailing @ (usually the case under Ultrix).
  7907.  
  7908. Example: if `ln -s foo bar; ls -F bar' gives `bar -> foo', set it to
  7909. nil (the default), if it gives `bar@ -> foo', set it to t.
  7910.  
  7911. Dired checks if there is really a @ appended.  Thus, if you have a
  7912. marking `ls' program on one host and a non-marking on another host, and
  7913. don't care about symbolic links which really end in a @, you can
  7914. always set this variable to t.
  7915. Vdired-trivial-filenames
  7916. *Regexp of files to skip when finding first file of a directory.
  7917. A value of nil means move to the subdir line.
  7918. A value of t means move to first file.
  7919. Vdired-keep-marker-rename
  7920. *Controls marking of renamed files.
  7921. If t, files keep their previous marks when they are renamed.
  7922. If a character, renamed files (whether previously marked or not)
  7923. are afterward marked with that character.
  7924. Vdired-keep-marker-copy
  7925. *Controls marking of copied files.
  7926. If t, copied files are marked if and as the corresponding original files were.
  7927. If a character, copied files are unconditionally marked with that character.
  7928. Vdired-keep-marker-hardlink
  7929. *Controls marking of newly made hard links.
  7930. If t, they are marked if and as the files linked to were marked.
  7931. If a character, new links are unconditionally marked with that character.
  7932. Vdired-keep-marker-symlink
  7933. *Controls marking of newly made symbolic links.
  7934. If t, they are marked if and as the files linked to were marked.
  7935. If a character, new links are unconditionally marked with that character.
  7936. Vdired-dwim-target
  7937. *If non-nil, dired tries to guess a default target directory.
  7938. This means: if there is a dired buffer displayed in the next window,
  7939. use its current subdir, instead of the current subdir of this dired buffer.
  7940.  
  7941. The target is used in the prompt for file copy, rename etc.
  7942. Vdired-copy-preserve-time
  7943. *If non-nil, Dired preserves the last-modified time in a file copy.
  7944. (This works on only some systems.)
  7945. Fdired
  7946. "Edit" directory DIRNAME--delete, rename, print, etc. some files in it.
  7947. Optional second argument SWITCHES specifies the `ls' options used.
  7948. (Interactively, use a prefix argument to be able to specify SWITCHES.)
  7949. Dired displays a list of files in DIRNAME (which may also have
  7950. shell wildcards appended to select certain files).  If DIRNAME is a cons,
  7951. its first element is taken as the directory name and the resr as an explicit
  7952. list of files to make directory entries for.
  7953. \<dired-mode-map>You can move around in it with the usual commands.
  7954. You can flag files for deletion with \[dired-flag-file-deletion] and then
  7955. delete them by typing \[dired-do-flagged-delete].
  7956. Type \[describe-mode] after entering dired for more info.
  7957.  
  7958. If DIRNAME is already in a dired buffer, that buffer is used without refresh.
  7959. Fdired-other-window
  7960. "Edit" directory DIRNAME.  Like `dired' but selects in another window.
  7961. Fdired-other-frame
  7962. "Edit" directory DIRNAME.  Like `dired' but makes a new frame.
  7963. Fdired-noselect
  7964. Like `dired' but returns the dired buffer as value, does not select it.
  7965. Fdisassemble
  7966. Print disassembled code for OBJECT in (optional) BUFFER.
  7967. OBJECT can be a symbol defined as a function, or a function itself
  7968. (a lambda expression or a compiled-function object).
  7969. If OBJECT is not already compiled, we compile it, but do not
  7970. redefine OBJECT if it is a symbol.
  7971. Fdescribe-current-display-table
  7972. Describe the display table in use in the selected window and buffer.
  7973. Fmake-display-table
  7974. Return a new, empty display table.
  7975. Fstandard-display-8bit
  7976. Display characters in the range L to H literally.
  7977. Fstandard-display-default
  7978. Display characters in the range L to H using the default notation.
  7979. Fstandard-display-ascii
  7980. Display character C using string S.
  7981. Fstandard-display-g1
  7982. Display character C as character SC in the g1 character set.
  7983. Fstandard-display-graphic
  7984. Display character C as character GC in graphics character set.
  7985. Fstandard-display-underline
  7986. Display character C as character UC plus underlining.
  7987. Fstandard-display-european
  7988. Toggle display of European characters encoded with ISO 8859.
  7989. When enabled, characters in the range of 160 to 255 display not
  7990. as octal escapes, but as accented characters.
  7991. With prefix argument, enable European character display iff arg is positive.
  7992. Fdissociated-press
  7993. Dissociate the text of the current buffer.
  7994. Output goes in buffer named *Dissociation*,
  7995. which is redisplayed each time text is added to it.
  7996. Every so often the user must say whether to continue.
  7997. If ARG is positive, require ARG chars of continuity.
  7998. If ARG is negative, require -ARG words of continuity.
  7999. Default is 2.
  8000. Fdoctor
  8001. Switch to *doctor* buffer and start giving psychotherapy.
  8002. Fdunnet
  8003. Switch to *dungeon* buffer and start game.
  8004. Felectric-buffer-list
  8005. Pops up a buffer describing the set of Emacs buffers.
  8006. Vaguely like ITS lunar select buffer; combining typeoutoid buffer
  8007. listing with menuoid buffer selection.
  8008.  
  8009. If the very next character typed is a space then the buffer list
  8010. window disappears.  Otherwise, one may move around in the buffer list
  8011. window, marking buffers to be selected, saved or deleted.
  8012.  
  8013. To exit and select a new buffer, type a space when the cursor is on
  8014. the appropriate line of the buffer-list window.  Other commands are
  8015. much like those of buffer-menu-mode.
  8016.  
  8017. Calls value of `electric-buffer-menu-mode-hook' on entry if non-nil.
  8018.  
  8019. \{electric-buffer-menu-mode-map}
  8020. FElectric-command-history-redo-expression
  8021. Edit current history line in minibuffer and execute result.
  8022. With prefix arg NOCONFIRM, execute current line as-is without editing.
  8023. Fedebug-defun
  8024. Evaluate defun or defmacro, like eval-defun, but with edebug calls.
  8025. Print its name in the minibuffer and leave point after any error it finds,
  8026. with mark at the original point.
  8027. Vglobal-edebug-prefix
  8028. Prefix key for global edebug commands, available from any buffer.
  8029. Vglobal-edebug-map
  8030. Global map of edebug commands, available from any buffer.
  8031. Fedebug-debug
  8032. Replacement for debug.  
  8033. If an error or quit occurred and we are running an edebugged function,
  8034. show where we last were.  Otherwise call debug normally.
  8035. Fedit-last-kbd-macro
  8036. Edit the most recently defined keyboard macro.
  8037. Fedit-kbd-macro
  8038. Edit a keyboard macro which has been given a name by `name-last-kbd-macro'.
  8039. (See also `edit-last-kbd-macro'.)
  8040. Fread-kbd-macro
  8041. Read the region as a keyboard macro definition.
  8042. The region is interpreted as spelled-out keystrokes, e.g., "M-x abc RET".
  8043. The resulting macro is installed as the "current" keyboard macro.
  8044.  
  8045. Symbols:  RET, SPC, TAB, DEL, LFD, NUL; C-key; M-key.  (Must be uppercase.)
  8046.           REM marks the rest of a line as a comment.
  8047.           Whitespace is ignored; other characters are copied into the macro.
  8048. Fedt-emulation-on
  8049. Emulate DEC's EDT editor.
  8050. Note that many keys are rebound; including nearly all keypad keys.
  8051. Use \[edt-emulation-off] to undo all rebindings except the keypad keys.
  8052. Freport-emacs-bug
  8053. Report a bug in GNU Emacs.
  8054. Prompts for bug subject.  Leaves you in a mail buffer.
  8055. Femerge-files
  8056. Run Emerge on two files.
  8057. Femerge-files-with-ancestor
  8058. Run Emerge on two files, giving another file as the ancestor.
  8059. Femerge-buffers
  8060. Run Emerge on two buffers.
  8061. Femerge-buffers-with-ancestor
  8062. Run Emerge on two buffers, giving another buffer as the ancestor.
  8063. Fsetenv
  8064. Set the value of the environment variable named VARIABLE to VALUE.
  8065. VARIABLE should be a string.  VALUE is optional; if not provided or is
  8066. `nil', the environment variable VARIABLE will be removed.  
  8067. This function works by modifying `process-environment'.
  8068. Vtags-file-name
  8069. *File name of tags table.
  8070. To switch to a new tags table, setting this variable is sufficient.
  8071. If you set this variable, do not also set `tags-table-list'.
  8072. Use the `etags' program to make a tags table file.
  8073. Vtags-table-list
  8074. *List of file names of tags tables to search.
  8075. An element that is a directory means the file "TAGS" in that directory.
  8076. To switch to a new list of tags tables, setting this variable is sufficient.
  8077. If you set this variable, do not also set `tags-file-name'.
  8078. Use the `etags' program to make a tags table file.
  8079. Vfind-tag-hook
  8080. *Hook to be run by \[find-tag] after finding a tag.  See `run-hooks'.
  8081. The value in the buffer in which \[find-tag] is done is used,
  8082. not the value in the buffer \[find-tag] goes to.
  8083. Vfind-tag-default-function
  8084. *A function of no arguments used by \[find-tag] to pick a default tag.
  8085. If nil, and the symbol that is the value of `major-mode'
  8086. has a `find-tag-default-function' property (see `put'), that is used.
  8087. Otherwise, `find-tag-default' is used.
  8088. Vdefault-tags-table-function
  8089. *If non-nil, a function of no arguments to choose a default tags file
  8090. for a particular buffer.
  8091. Fvisit-tags-table
  8092. Tell tags commands to use tags table file FILE.
  8093. FILE should be the name of a file created with the `etags' program.
  8094. A directory name is ok too; it means file TAGS in that directory.
  8095.  
  8096. Normally \[visit-tags-table] sets the global value of `tags-file-name'.
  8097. With a prefix arg, set the buffer-local value instead.
  8098. When you find a tag with \[find-tag], the buffer it finds the tag
  8099. in is given a local value of this variable which is the name of the tags
  8100. file the tag was in.
  8101. Ftags-table-files
  8102. Return a list of files in the current tags table.
  8103. Assumes the tags table is the current buffer.
  8104. File names returned are absolute.
  8105. Ffind-tag-noselect
  8106. Find tag (in current tags table) whose name contains TAGNAME.
  8107. Returns the buffer containing the tag's definition and moves its point there,
  8108. but does not select the buffer.
  8109. The default for TAGNAME is the expression in the buffer near point.
  8110.  
  8111. If second arg NEXT-P is t (interactively, with prefix arg), search for
  8112. another tag that matches the last tagname or regexp used.  When there are
  8113. multiple matches for a tag, more exact matches are found first.  If NEXT-P
  8114. is the atom `-' (interactively, with prefix arg that is a negative number
  8115. or just \[negative-argument]), pop back to the previous tag gone to.
  8116.  
  8117. If third arg REGEXP-P is non-nil, treat TAGNAME as a regexp.
  8118.  
  8119. See documentation of variable `tags-file-name'.
  8120. Ffind-tag
  8121. Find tag (in current tags table) whose name contains TAGNAME.
  8122. Select the buffer containing the tag's definition, and move point there.
  8123. The default for TAGNAME is the expression in the buffer around or before point.
  8124.  
  8125. If second arg NEXT-P is t (interactively, with prefix arg), search for
  8126. another tag that matches the last tagname or regexp used.  When there are
  8127. multiple matches for a tag, more exact matches are found first.  If NEXT-P
  8128. is the atom `-' (interactively, with prefix arg that is a negative number
  8129. or just \[negative-argument]), pop back to the previous tag gone to.
  8130.  
  8131. See documentation of variable `tags-file-name'.
  8132. Ffind-tag-other-window
  8133. Find tag (in current tags table) whose name contains TAGNAME.
  8134. Select the buffer containing the tag's definition in another window, and
  8135. move point there.  The default for TAGNAME is the expression in the buffer
  8136. around or before point.
  8137.  
  8138. If second arg NEXT-P is t (interactively, with prefix arg), search for
  8139. another tag that matches the last tagname or regexp used.  When there are
  8140. multiple matches for a tag, more exact matches are found first.  If NEXT-P
  8141. is negative (interactively, with prefix arg that is a negative number or
  8142. just \[negative-argument]), pop back to the previous tag gone to.
  8143.  
  8144. See documentation of variable `tags-file-name'.
  8145. Ffind-tag-other-frame
  8146. Find tag (in current tags table) whose name contains TAGNAME.
  8147. Select the buffer containing the tag's definition in another frame, and
  8148. move point there.  The default for TAGNAME is the expression in the buffer
  8149. around or before point.
  8150.  
  8151. If second arg NEXT-P is t (interactively, with prefix arg), search for
  8152. another tag that matches the last tagname or regexp used.  When there are
  8153. multiple matches for a tag, more exact matches are found first.  If NEXT-P
  8154. is negative (interactively, with prefix arg that is a negative number or
  8155. just \[negative-argument]), pop back to the previous tag gone to.
  8156.  
  8157. See documentation of variable `tags-file-name'.
  8158. Ffind-tag-regexp
  8159. Find tag (in current tags table) whose name matches REGEXP.
  8160. Select the buffer containing the tag's definition and move point there.
  8161.  
  8162. If second arg NEXT-P is t (interactively, with prefix arg), search for
  8163. another tag that matches the last tagname or regexp used.  When there are
  8164. multiple matches for a tag, more exact matches are found first.  If NEXT-P
  8165. is negative (interactively, with prefix arg that is a negative number or
  8166. just \[negative-argument]), pop back to the previous tag gone to.
  8167.  
  8168. If third arg OTHER-WINDOW is non-nil, select the buffer in another window.
  8169.  
  8170. See documentation of variable `tags-file-name'.
  8171. Fnext-file
  8172. Select next file among files in current tags table.
  8173.  
  8174. A first argument of t (prefix arg, if interactive) initializes to the
  8175. beginning of the list of files in the tags table.  If the argument is
  8176. neither nil nor t, it is evalled to initialize the list of files.
  8177.  
  8178. Non-nil second argument NOVISIT means use a temporary buffer
  8179.  to save time and avoid uninteresting warnings.
  8180.  
  8181. Value is nil if the file was already visited;
  8182. if the file was newly read in, the value is the filename.
  8183. Ftags-loop-continue
  8184. Continue last \[tags-search] or \[tags-query-replace] command.
  8185. Used noninteractively with non-nil argument to begin such a command (the
  8186. argument is passed to `next-file', which see).
  8187. Two variables control the processing we do on each file:
  8188. the value of `tags-loop-scan' is a form to be executed on each file
  8189. to see if it is interesting (it returns non-nil if so)
  8190. and `tags-loop-operate' is a form to execute to operate on an interesting file
  8191. If the latter returns non-nil, we exit; otherwise we scan the next file.
  8192. Ftags-search
  8193. Search through all files listed in tags table for match for REGEXP.
  8194. Stops when a match is found.
  8195. To continue searching for next match, use command \[tags-loop-continue].
  8196.  
  8197. See documentation of variable `tags-file-name'.
  8198. Ftags-query-replace
  8199. Query-replace-regexp FROM with TO through all files listed in tags table.
  8200. Third arg DELIMITED (prefix arg) means replace only word-delimited matches.
  8201. If you exit (\[keyboard-quit] or ESC), you can resume the query-replace
  8202. with the command \[tags-loop-continue].
  8203.  
  8204. See documentation of variable `tags-file-name'.
  8205. Flist-tags
  8206. Display list of tags in file FILE.
  8207. FILE should not contain a directory specification.
  8208. Ftags-apropos
  8209. Display list of all tags in tags table REGEXP matches.
  8210. Fselect-tags-table
  8211. Select a tags table file from a menu of those you have already used.
  8212. The list of tags tables to select from is stored in `tags-table-file-list';
  8213. see the doc of that variable if you want to add names to the list.
  8214. Fcomplete-tag
  8215. Perform tags completion on the text around point.
  8216. Completes to the set of names listed in the current tags table.  
  8217. The string to complete is chosen in the same way as the default
  8218. for \[find-tag] (which see).
  8219. Vfind-ls-option
  8220. *Option to `find' to produce an `ls -l'-type listing.
  8221. Vfind-grep-options
  8222. *Option to grep to be as silent as possible.
  8223. On Berkeley systems, this is `-s', for others it seems impossible to
  8224. suppress all output, so `-l' is used to print nothing more than the
  8225. file name.
  8226. Ffind-dired
  8227. Run `find' and go into dired-mode on a buffer of the output.
  8228. The command run (after changing into DIR) is
  8229.  
  8230.     find . \( ARGS \) -ls
  8231. Ffind-name-dired
  8232. Search DIR recursively for files matching the globbing pattern PATTERN,
  8233. and run dired on those files.
  8234. PATTERN is a shell wildcard (not an Emacs regexp) and need not be quoted.
  8235. The command run (after changing into DIR) is
  8236.  
  8237.     find . -name 'PATTERN' -ls
  8238. Ffind-grep-dired
  8239. Find files in DIR containing a regexp ARG and start Dired on output.
  8240. The command run (after changing into DIR) is
  8241.  
  8242.     find . -exec grep -s ARG {} \; -ls
  8243.  
  8244. Thus ARG can also contain additional grep options.
  8245. Fenable-flow-control
  8246. Enable use of flow control; let user type C-s as C-\ and C-q as C-^.
  8247. Fenable-flow-control-on
  8248. Enable flow control if using one of a specified set of terminal types.
  8249. Use `(enable-flow-control-on "vt100" "h19")' to enable flow control
  8250. on VT-100 and H19 terminals.  When flow control is enabled,
  8251. you must type C-\ to get the effect of a C-s, and type C-^
  8252. to get the effect of a C-q.
  8253. Vfont-lock-mode-hook
  8254. Function or functions to run on entry to Font Lock mode.
  8255. Ffont-lock-mode
  8256. Toggle Font Lock mode.
  8257. With arg, turn Font Lock mode on if and only if arg is positive.
  8258.  
  8259. When Font Lock mode is enabled, text is fontified as you type it:
  8260.  
  8261.  - comments are displayed in `font-lock-comment-face';
  8262.      (That is a variable whose value should be a face name.)
  8263.  - strings are displayed in `font-lock-string-face';
  8264.  - documentation strings are displayed in `font-lock-doc-string-face';
  8265.  - function and variable names in their defining forms are displayed
  8266.    in `font-lock-function-name-face';
  8267.  - and certain other expressions are displayed in other faces
  8268.    according to the value of the variable `font-lock-keywords'.
  8269.  
  8270. When you turn Font Lock mode on/off, the buffer is fontified/defontified.
  8271. To fontify a buffer without having newly typed text become fontified, you
  8272. can use \[font-lock-fontify-buffer].
  8273. Fforms-mode
  8274. Major mode to visit files in a field-structured manner using a form.
  8275.  
  8276. Commands (prefix with C-c if not in read-only mode):
  8277. \{forms-mode-map}
  8278. Fforms-find-file
  8279. Visit a file in Forms mode.
  8280. Fforms-find-file-other-window
  8281. Visit a file in Forms mode in other window.
  8282. Vfortran-tab-mode-default
  8283. *Default tabbing/carriage control style for empty files in Fortran mode.
  8284. A value of t specifies tab-digit style of continuation control.
  8285. A value of nil specifies that continuation lines are marked
  8286. with a character in column 6.
  8287. Ffortran-mode
  8288. Major mode for editing Fortran code.
  8289. \[fortran-indent-line] indents the current Fortran line correctly. 
  8290. DO statements must not share a common CONTINUE.
  8291.  
  8292. Type ;? or ;\[help-command] to display a list of built-in abbrevs for Fortran keywords.
  8293.  
  8294. Key definitions:
  8295. \{fortran-mode-map}
  8296.  
  8297. Variables controlling indentation style and extra features:
  8298.  
  8299.  comment-start
  8300.     Normally nil in Fortran mode.  If you want to use comments
  8301.     starting with `!', set this to the string "!".
  8302.  fortran-do-indent
  8303.     Extra indentation within do blocks.  (default 3)
  8304.  fortran-if-indent
  8305.     Extra indentation within if blocks.  (default 3)
  8306.  fortran-structure-indent
  8307.     Extra indentation within structure, union and map blocks.  (default 3)
  8308.  fortran-continuation-indent
  8309.     Extra indentation applied to continuation statements.  (default 5)
  8310.  fortran-comment-line-extra-indent
  8311.     Amount of extra indentation for text within full-line comments. (default 0)
  8312.  fortran-comment-indent-style
  8313.     nil    means don't change indentation of text in full-line comments,
  8314.     fixed  means indent that text at `fortran-comment-line-extra-indent' beyond
  8315.            the value of `fortran-minimum-statement-indent-fixed' (for fixed
  8316.            format continuation style) or `fortran-minimum-statement-indent-tab'
  8317.            (for TAB format continuation style).
  8318.     relative  means indent at `fortran-comment-line-extra-indent' beyond the
  8319.            indentation for a line of code.
  8320.     (default 'fixed)
  8321.  fortran-comment-indent-char
  8322.     Single-character string to be inserted instead of space for
  8323.     full-line comment indentation.  (default " ")
  8324.  fortran-minimum-statement-indent-fixed
  8325.     Minimum indentation for Fortran statements in fixed format mode. (def.6)
  8326.  fortran-minimum-statement-indent-tab
  8327.     Minimum indentation for Fortran statements in TAB format mode. (default 9)
  8328.  fortran-line-number-indent
  8329.     Maximum indentation for line numbers.  A line number will get
  8330.     less than this much indentation if necessary to avoid reaching
  8331.     column 5.  (default 1)
  8332.  fortran-check-all-num-for-matching-do
  8333.     Non-nil causes all numbered lines to be treated as possible "continue"
  8334.     statements.  (default nil)
  8335.  fortran-blink-matching-if 
  8336.     From a Fortran ENDIF statement, blink the matching IF statement.
  8337.     (default nil)
  8338.  fortran-continuation-string
  8339.     Single-character string to be inserted in column 5 of a continuation
  8340.     line.  (default "$")
  8341.  fortran-comment-region
  8342.     String inserted by \[fortran-comment-region] at start of each line in 
  8343.     region.  (default "c$$$")
  8344.  fortran-electric-line-number
  8345.     Non-nil causes line number digits to be moved to the correct column 
  8346.     as typed.  (default t)
  8347.  fortran-break-before-delimiters
  8348.     Non-nil causes `fortran-do-auto-fill' breaks lines before delimiters.
  8349.     (default t)
  8350.  fortran-startup-message
  8351.     Set to nil to inhibit message first time Fortran mode is used.
  8352.  
  8353. Turning on Fortran mode calls the value of the variable `fortran-mode-hook'
  8354. with no args, if that value is non-nil.
  8355. Fgnus
  8356. Read network news.
  8357. If optional argument CONFIRM is non-nil, ask NNTP server.
  8358. Fgnus-post-news
  8359. Begin editing a new USENET news article to be posted.
  8360. Type \[describe-mode] once editing the article to get a list of commands.
  8361. Fgomoku
  8362. Start a Gomoku game between you and Emacs.
  8363. If a game is in progress, this command allow you to resume it.
  8364. If optional arguments N and M are given, an N by M board is used.
  8365.  
  8366. You and Emacs play in turn by marking a free square.  You mark it with X
  8367. and Emacs marks it with O. The winner is the first to get five contiguous
  8368. marks horizontally, vertically or in diagonal.
  8369.  
  8370. You play by moving the cursor over the square you choose and hitting
  8371. \<gomoku-mode-map>\[gomoku-human-plays].
  8372. Use \[describe-mode] for more info.
  8373. Fset-gosmacs-bindings
  8374. Rebind some keys globally to make GNU Emacs resemble Gosling Emacs.
  8375. Use \[set-gnu-bindings] to restore previous global bindings.
  8376. Fgdb
  8377. Run gdb on program FILE in buffer *gud-FILE*.
  8378. The directory containing FILE becomes the initial working directory
  8379. and source-file directory for your debugger.
  8380. Fsdb
  8381. Run sdb on program FILE in buffer *gud-FILE*.
  8382. The directory containing FILE becomes the initial working directory
  8383. and source-file directory for your debugger.
  8384. Fdbx
  8385. Run dbx on program FILE in buffer *gud-FILE*.
  8386. The directory containing FILE becomes the initial working directory
  8387. and source-file directory for your debugger.
  8388. Fxdb
  8389. Run xdb on program FILE in buffer *gud-FILE*.
  8390. The directory containing FILE becomes the initial working directory
  8391. and source-file directory for your debugger.
  8392.  
  8393. You can set the variable 'gud-xdb-directories' to a list of program source
  8394. directories if your program contains sources from more than one directory.
  8395. Fperldb
  8396. Run perldb on program FILE in buffer *gud-FILE*.
  8397. The directory containing FILE becomes the initial working directory
  8398. and source-file directory for your debugger.
  8399. Fhanoi
  8400. Towers of Hanoi diversion.  Argument is number of rings.
  8401. FHelper-describe-bindings
  8402. Describe local key bindings of current mode.
  8403. FHelper-help
  8404. Provide help for current mode.
  8405. Fhexl-mode
  8406. \<hexl-mode-map>
  8407. A major mode for editing binary files in hex dump format.
  8408.  
  8409. This function automatically converts a buffer into the hexl format
  8410. using the function `hexlify-buffer'.
  8411.  
  8412. Each line in the buffer has an "address" (displayed in hexadecimal)
  8413. representing the offset into the file that the characters on this line
  8414. are at and 16 characters from the file (displayed as hexadecimal
  8415. values grouped every 16 bits) and as their ASCII values.
  8416.  
  8417. If any of the characters (displayed as ASCII characters) are
  8418. unprintable (control or meta characters) they will be replaced as
  8419. periods.
  8420.  
  8421. If `hexl-mode' is invoked with an argument the buffer is assumed to be
  8422. in hexl format.
  8423.  
  8424. A sample format:
  8425.  
  8426.   HEX ADDR: 0001 0203 0405 0607 0809 0a0b 0c0d 0e0f     ASCII-TEXT
  8427.   --------  ---- ---- ---- ---- ---- ---- ---- ----  ----------------
  8428.   00000000: 5468 6973 2069 7320 6865 786c 2d6d 6f64  This is hexl-mod
  8429.   00000010: 652e 2020 4561 6368 206c 696e 6520 7265  e.  Each line re
  8430.   00000020: 7072 6573 656e 7473 2031 3620 6279 7465  presents 16 byte
  8431.   00000030: 7320 6173 2068 6578 6164 6563 696d 616c  s as hexadecimal
  8432.   00000040: 2041 5343 4949 0a61 6e64 2070 7269 6e74   ASCII.and print
  8433.   00000050: 6162 6c65 2041 5343 4949 2063 6861 7261  able ASCII chara
  8434.   00000060: 6374 6572 732e 2020 416e 7920 636f 6e74  cters.  Any cont
  8435.   00000070: 726f 6c20 6f72 206e 6f6e 2d41 5343 4949  rol or non-ASCII
  8436.   00000080: 2063 6861 7261 6374 6572 730a 6172 6520   characters.are 
  8437.   00000090: 6469 7370 6c61 7965 6420 6173 2070 6572  displayed as per
  8438.   000000a0: 696f 6473 2069 6e20 7468 6520 7072 696e  iods in the prin
  8439.   000000b0: 7461 626c 6520 6368 6172 6163 7465 7220  table character 
  8440.   000000c0: 7265 6769 6f6e 2e0a                      region..
  8441.  
  8442. Movement is as simple as movement in a normal emacs text buffer.  Most
  8443. cursor movement bindings are the same (ie. Use \[hexl-backward-char], \[hexl-forward-char], \[hexl-next-line], and \[hexl-previous-line]
  8444. to move the cursor left, right, down, and up).
  8445.  
  8446. Advanced cursor movement commands (ala \[hexl-beginning-of-line], \[hexl-end-of-line], \[hexl-beginning-of-buffer], and \[hexl-end-of-buffer]) are
  8447. also supported.
  8448.  
  8449. There are several ways to change text in hexl mode:
  8450.  
  8451. ASCII characters (character between space (0x20) and tilde (0x7E)) are
  8452. bound to self-insert so you can simply type the character and it will
  8453. insert itself (actually overstrike) into the buffer.
  8454.  
  8455. \[hexl-quoted-insert] followed by another keystroke allows you to insert the key even if
  8456. it isn't bound to self-insert.  An octal number can be supplied in place
  8457. of another key to insert the octal number's ASCII representation.
  8458.  
  8459. \[hexl-insert-hex-char] will insert a given hexadecimal value (if it is between 0 and 0xFF)
  8460. into the buffer at the current point.
  8461.  
  8462. \[hexl-insert-octal-char] will insert a given octal value (if it is between 0 and 0377)
  8463. into the buffer at the current point.
  8464.  
  8465. \[hexl-insert-decimal-char] will insert a given decimal value (if it is between 0 and 255)
  8466. into the buffer at the current point.
  8467.  
  8468. \[hexl-mode-exit] will exit hexl-mode.
  8469.  
  8470. Note: saving the file with any of the usual Emacs commands
  8471. will actually convert it back to binary format while saving.
  8472.  
  8473. You can use \[hexl-find-file] to visit a file in hexl-mode.
  8474.  
  8475. \[describe-bindings] for advanced commands.
  8476. Fhexl-find-file
  8477. Edit file FILENAME in hexl-mode.
  8478. Switch to a buffer visiting file FILENAME, creating one in none exists.
  8479. Fhexlify-buffer
  8480. Convert a binary buffer to hexl format
  8481. Fhide-ifdef-mode
  8482. Toggle Hide-Ifdef mode.  This is a minor mode, albeit a large one.
  8483. With ARG, turn Hide-Ifdef mode on iff arg is positive.
  8484. In Hide-Ifdef mode, code within #ifdef constructs that the C preprocessor
  8485. would eliminate may be hidden from view.  Several variables affect
  8486. how the hiding is done:
  8487.  
  8488. hide-ifdef-env
  8489.     An association list of defined and undefined symbols for the
  8490.     current buffer.  Initially, the global value of `hide-ifdef-env'
  8491.     is used.
  8492.  
  8493. hide-ifdef-define-alist
  8494.     An association list of defined symbol lists.  
  8495.         Use `hide-ifdef-set-define-alist' to save the current `hide-ifdef-env'
  8496.         and `hide-ifdef-use-define-alist' to set the current `hide-ifdef-env'
  8497.         from one of the lists in `hide-ifdef-define-alist'.
  8498.  
  8499. hide-ifdef-lines
  8500.     Set to non-nil to not show #if, #ifdef, #ifndef, #else, and
  8501.     #endif lines when hiding.
  8502.  
  8503. hide-ifdef-initially
  8504.     Indicates whether `hide-ifdefs' should be called when Hide-Ifdef mode
  8505.     is activated.
  8506.  
  8507. hide-ifdef-read-only
  8508.     Set to non-nil if you want to make buffers read only while hiding.
  8509.     After `show-ifdefs', read-only status is restored to previous value.
  8510.  
  8511. \{hide-ifdef-mode-map}
  8512. Vhide-ifdef-initially
  8513. *Non-nil if `hide-ifdefs' should be called when Hide-Ifdef mode
  8514. is first activated.
  8515. Vhide-ifdef-read-only
  8516. *Set to non-nil if you want buffer to be read-only while hiding text.
  8517. Vhide-ifdef-lines
  8518. *Set to t if you don't want to see the #ifX, #else, and #endif lines.
  8519. Vhippie-expand-try-functions-list
  8520. The list of expansion functions tried in order by `hippie-expand'.
  8521. To change the behavior of `hippie-expand', remove, change the order of,
  8522. or insert functions in this list.
  8523. Vhippie-expand-verbose
  8524. *Non-nil makes `hippie-expand' output which function it is trying.
  8525. Vhippie-expand-max-buffers
  8526. *The maximum number of buffers (apart from the current) searched.
  8527. If nil, all buffers are searched.
  8528. Fhippie-expand
  8529. Try to expand text before point, using multiple methods.
  8530. The expansion functions in `hippie-expand-try-functions-list' are
  8531. tried in order, until a possible expansion is found.  Repeated
  8532. application of `hippie-expand' inserts successively possible
  8533. expansions.  
  8534. With a positive numeric argument, jumps directly to the ARG next
  8535. function in this list.  With a negative argument or just \[universal-argument], 
  8536. undoes the expansion.
  8537. Fmake-hippie-expand-function
  8538. Construct a function similar to `hippie-expand'.
  8539. Make it use the expansion functions in TRY-LIST.  An optional second
  8540. argument VERBOSE non-nil makes the function verbose.
  8541. Vinferior-lisp-filter-regexp
  8542. *What not to save on inferior Lisp's input history.
  8543. Input matching this regexp is not saved on the input history in Inferior Lisp
  8544. mode.  Default is whitespace followed by 0 or 1 single-letter colon-keyword 
  8545. (as in :a, :c, etc.)
  8546. Vinferior-lisp-program
  8547. *Program name for invoking an inferior Lisp with for Inferior Lisp mode.
  8548. Vinferior-lisp-load-command
  8549. *Format-string for building a Lisp expression to load a file.
  8550. This format string should use `%s' to substitute a file name
  8551. and should result in a Lisp expression that will command the inferior Lisp
  8552. to load that file.  The default works acceptably on most Lisps.
  8553. The string "(progn (load \"%s\" :verbose nil :print t) (values))\
  8554. "
  8555. produces cosmetically superior output for this application,
  8556. but it works only in Common Lisp.
  8557. Vinferior-lisp-prompt
  8558. Regexp to recognise prompts in the Inferior Lisp mode.
  8559. Defaults to "^[^> ]*>+:? *", which works pretty good for Lucid, kcl,
  8560. and franz.  This variable is used to initialize `comint-prompt-regexp' in the 
  8561. Inferior Lisp buffer.
  8562.  
  8563. More precise choices:
  8564. Lucid Common Lisp: "^\(>\|\(->\)+\) *"
  8565. franz: "^\(->\|<[0-9]*>:\) *"
  8566. kcl: "^>+ *"
  8567.  
  8568. This is a fine thing to set in your .emacs file.
  8569. Vinferior-lisp-mode-hook
  8570. *Hook for customising Inferior Lisp mode.
  8571. Finferior-lisp
  8572. Run an inferior Lisp process, input and output via buffer `*inferior-lisp*'.
  8573. If there is a process already running in `*inferior-lisp*', just switch
  8574. to that buffer.
  8575. With argument, allows you to edit the command line (default is value
  8576. of `inferior-lisp-program').  Runs the hooks from
  8577. `inferior-lisp-mode-hook' (after the `comint-mode-hook' is run).
  8578. (Type \[describe-mode] in the process buffer for a list of commands.)
  8579. Finfo
  8580. Enter Info, the documentation browser.
  8581. Optional argument FILE specifies the file to examine;
  8582. the default is the top-level directory of Info.
  8583.  
  8584. In interactive use, a prefix argument directs this command
  8585. to read a file name from the minibuffer.
  8586. Finfo-standalone
  8587. Run Emacs as a standalone Info reader.
  8588. Usage:  emacs -f info-standalone [filename]
  8589. In standalone mode, \<Info-mode-map>\[Info-exit] exits Emacs itself.
  8590. FInfo-goto-emacs-command-node
  8591. Go to the Info node in the Emacs manual for command COMMAND.
  8592. The command is found by looking up in Emacs manual's Command Index.
  8593. FInfo-goto-emacs-key-command-node
  8594. Go to the Info node in the Emacs manual the command bound to KEY, a string.
  8595. Interactively, if the binding is execute-extended-command, a command is read.
  8596. The command is found by looking up in Emacs manual's Command Index.
  8597. FInfo-tagify
  8598. Create or update Info-file tag table in current buffer.
  8599. FInfo-split
  8600. Split an info file into an indirect file plus bounded-size subfiles.
  8601. Each subfile will be up to 50,000 characters plus one node.
  8602.  
  8603. To use this command, first visit a large Info file that has a tag
  8604. table.  The buffer is modified into a (small) indirect info file which
  8605. should be saved in place of the original visited file.
  8606.  
  8607. The subfiles are written in the same directory the original file is
  8608. in, with names generated by appending `-' and a number to the original
  8609. file name.  The indirect file still functions as an Info file, but it
  8610. contains just the tag table and a directory of subfiles.
  8611. FInfo-validate
  8612. Check current buffer for validity as an Info file.
  8613. Check that every node pointer points to an existing node.
  8614. Fbatch-info-validate
  8615. Runs `Info-validate' on the files remaining on the command line.
  8616. Must be used only with -batch, and kills Emacs on completion.
  8617. Each file will be processed even if an error occurred previously.
  8618. For example, invoke "emacs -batch -f batch-info-validate $info/ ~/*.info"
  8619. Fiso-accents-mode
  8620. Toggle a minor mode in which accents modify the following letter.
  8621. This permits easy insertion of accented characters according to ISO-8859-1.
  8622. When Iso-accents mode is enabled, accent character keys
  8623. (', ", ^ and ~) do not self-insert; instead, they modify the following
  8624. letter key so that it inserts an ISO accented letter.
  8625.  
  8626. With an argument, a positive argument enables ISO-accents mode, 
  8627. and a negative argument disables it.
  8628. Fispell
  8629. Run Ispell over current buffer's visited file.
  8630. First the file is scanned for misspelled words, then Ispell
  8631. enters a loop with the following commands for every misspelled word:
  8632.  
  8633. DIGIT    Near miss selector.  If the misspelled word is close to
  8634.     some words in the dictionary, they are offered as near misses.
  8635. r    Replace.  Replace the word with a string you type.  Each word
  8636.     of your new string is also checked.
  8637. i    Insert.  Insert this word in your private dictionary (kept in
  8638.     `$HOME/ispell.words').
  8639. a    Accept.  Accept this word for the rest of this editing session,
  8640.      but don't put it in your private dictionary.
  8641. l    Lookup.  Look for a word in the dictionary by fast binary
  8642.     search, or search for a regular expression in the dictionary
  8643.     using grep.
  8644. SPACE    Accept the word this time, but complain if it is seen again.
  8645. q, \[keyboard-quit]    Leave the command loop.  You can come back later with \[ispell-next].
  8646. Fispell-word
  8647. Check the spelling of the word under the cursor.
  8648. See the command `ispell' for more information.
  8649. With a prefix argument, resume handling of the previous Ispell command.
  8650. Fispell-region
  8651. Check the spelling for all of the words in the region.
  8652. Fispell-complete-word
  8653. Complete word using letters at point to word beginning using `look'.
  8654. With optional argument INTERIOR-FRAG, word fragment at point is assumed to be
  8655. an interior word fragment in which case `ispell-have-new-look' should be t.
  8656. See also `ispell-look-dictionary' and `ispell-gnu-look-still-broken-p'.
  8657. Fispell-complete-word-interior-frag
  8658. Runs `ispell-complete-word' with a non-nil INTERIOR-FRAG.
  8659. A completion list is built for word fragment at point which is assumed to be
  8660. an interior word fragment.  `ispell-have-new-look' should be t.
  8661. Fispell-message
  8662. Check the spelling of a mail message or news post.
  8663. Don't check spelling of message headers or included messages.
  8664.  
  8665. To spell-check whenever a message is sent, include this line in .emacs:
  8666.    (setq news-inews-hook (setq mail-send-hook 'ispell-message))
  8667.  
  8668. Or you can bind the function to C-c i in gnus or mail with:
  8669.    (setq mail-mode-hook (setq news-reply-mode-hook
  8670.     (function (lambda () (local-set-key "\C-ci" 'ispell-message)))))
  8671. Vledit-save-files
  8672. *Non-nil means Ledit should save files before transferring to Lisp.
  8673. Vledit-go-to-lisp-string
  8674. *Shell commands to execute to resume Lisp job.
  8675. Vledit-go-to-liszt-string
  8676. *Shell commands to execute to resume Lisp compiler job.
  8677. Fledit-mode
  8678. \<ledit-mode-map>Major mode for editing text and stuffing it to a Lisp job.
  8679. Like Lisp mode, plus these special commands:
  8680.   \[ledit-save-defun]    -- record defun at or after point
  8681.        for later transmission to Lisp job.
  8682.   \[ledit-save-region] -- record region for later transmission to Lisp job.
  8683.   \[ledit-go-to-lisp] -- transfer to Lisp job and transmit saved text.
  8684.   \[ledit-go-to-liszt] -- transfer to Liszt (Lisp compiler) job
  8685.        and transmit saved text.
  8686. \{ledit-mode-map}
  8687. To make Lisp mode automatically change to Ledit mode,
  8688. do (setq lisp-mode-hook 'ledit-from-lisp-mode)
  8689. Flife
  8690. Run Conway's Life simulation.
  8691. The starting pattern is randomly selected.  Prefix arg (optional first
  8692. arg non-nil from a program) is the number of seconds to sleep between
  8693. generations (this defaults to 1).
  8694. Funload-feature
  8695. Unload the library that provided FEATURE, restoring all its autoloads.
  8696. If the feature is required by any other loaded code, and optional FORCE
  8697. is nil, raise an error.
  8698. Vlpr-switches
  8699. *List of strings to pass as extra switch args to lpr when it is invoked.
  8700. Vlpr-command
  8701. *Shell command for printing a file
  8702. Flpr-buffer
  8703. Print buffer contents as with Unix command `lpr'.
  8704. `lpr-switches' is a list of extra switches (strings) to pass to lpr.
  8705. Fprint-buffer
  8706. Print buffer contents as with Unix command `lpr -p'.
  8707. `lpr-switches' is a list of extra switches (strings) to pass to lpr.
  8708. Flpr-region
  8709. Print region contents as with Unix command `lpr'.
  8710. `lpr-switches' is a list of extra switches (strings) to pass to lpr.
  8711. Fprint-region
  8712. Print region contents as with Unix command `lpr -p'.
  8713. `lpr-switches' is a list of extra switches (strings) to pass to lpr.
  8714. Fphases-of-moon
  8715. Display the quarters of the moon for last month, this month, and next month.
  8716. If called with an optional prefix argument, prompts for month and year.
  8717.  
  8718. This function is suitable for execution in a .emacs file.
  8719. Fname-last-kbd-macro
  8720. Assign a name to the last keyboard macro defined.
  8721. Argument SYMBOL is the name to define.
  8722. The symbol's function definition becomes the keyboard macro string.
  8723. Such a "function" cannot be called from Lisp, but it is a valid editor command.
  8724. Finsert-kbd-macro
  8725. Insert in buffer the definition of kbd macro NAME, as Lisp code.
  8726. Optional second arg KEYS means also record the keys it is on
  8727. (this is the prefix argument, when calling interactively).
  8728.  
  8729. This Lisp code will, when executed, define the kbd macro with the same
  8730. definition it has now.  If you say to record the keys, the Lisp code
  8731. will also rebind those keys to the macro.  Only global key bindings
  8732. are recorded since executing this Lisp code always makes global
  8733. bindings.
  8734.  
  8735. To save a kbd macro, visit a file of Lisp code such as your `~/.emacs',
  8736. use this command, and then save the file.
  8737. Fkbd-macro-query
  8738. Query user during kbd macro execution.
  8739.   With prefix argument, enters recursive edit, reading keyboard
  8740. commands even within a kbd macro.  You can give different commands
  8741. each time the macro executes.
  8742.   Without prefix argument, asks whether to continue running the macro.
  8743. Your options are: \<query-replace-map>
  8744. \[act]    Finish this iteration normally and continue with the next.
  8745. \[skip]    Skip the rest of this iteration, and start the next.
  8746. \[exit]    Stop the macro entirely right now.
  8747. \[recenter]    Redisplay the screen, then ask again.
  8748. \[edit]    Enter recursive edit; ask again when you exit from that.
  8749. Fapply-macro-to-region-lines
  8750. For each complete line between point and mark, move to the beginning
  8751. of the line, and run the last keyboard macro.
  8752.  
  8753. When called from lisp, this function takes two arguments TOP and
  8754. BOTTOM, describing the current region.  TOP must be before BOTTOM.
  8755. The optional third argument MACRO specifies a keyboard macro to
  8756. execute.
  8757.  
  8758. This is useful for quoting or unquoting included text, adding and
  8759. removing comments, or producing tables where the entries are regular.
  8760.  
  8761. For example, in Usenet articles, sections of text quoted from another
  8762. author are indented, or have each line start with `>'.  To quote a
  8763. section of text, define a keyboard macro which inserts `>', put point
  8764. and mark at opposite ends of the quoted section, and use
  8765. `\[apply-macro-to-region-lines]' to mark the entire section.
  8766.  
  8767. Suppose you wanted to build a keyword table in C where each entry
  8768. looked like this:
  8769.  
  8770.     { "foo", foo_data, foo_function }, 
  8771.     { "bar", bar_data, bar_function },
  8772.     { "baz", baz_data, baz_function },
  8773.  
  8774. You could enter the names in this format:
  8775.  
  8776.     foo
  8777.     bar
  8778.     baz
  8779.  
  8780. and write a macro to massage a word into a table entry:
  8781.  
  8782.     \C-x (
  8783.        \M-d { "\C-y", \C-y_data, \C-y_function },
  8784.     \C-x )
  8785.  
  8786. and then select the region of un-tablified names and use
  8787. `\[apply-macro-to-region-lines]' to build the table from the names.
  8788.  
  8789. Vmail-use-rfc822
  8790. *If non-nil, use a full, hairy RFC822 parser on mail addresses.
  8791. Otherwise, (the default) use a smaller, somewhat faster, and
  8792. often correct parser.
  8793. Fbuild-mail-abbrevs
  8794. Read mail aliases from `~/.mailrc' file and set `mail-abbrevs'.
  8795. Fdefine-mail-abbrev
  8796. Define NAME as a mail-abbrev that translates to DEFINITION.
  8797. If DEFINITION contains multiple addresses, separate them with commas.
  8798. Fdefine-mail-alias
  8799. Define NAME as a mail alias that translates to DEFINITION.
  8800. This means that sending a message to NAME will actually send to DEFINITION.
  8801. DEFINITION can be one or more mail addresses separated by commas.
  8802. Fmakefile-mode
  8803. Major mode for editing Makefiles.
  8804. Calling this function invokes the function(s) "makefile-mode-hook" before
  8805. doing anything else.
  8806.  
  8807. \{makefile-mode-map}
  8808.  
  8809. In the browser, use the following keys:
  8810.  
  8811. \{makefile-browser-map}
  8812.  
  8813. makefile-mode can be configured by modifying the following
  8814. variables:
  8815.  
  8816. makefile-mode-name:
  8817.     The "pretty name" of makefile-mode, as it
  8818.     appears in the modeline.
  8819.  
  8820. makefile-browser-buffer-name:
  8821.     Name of the macro- and target browser buffer.
  8822.  
  8823. makefile-target-colon:
  8824.     The string that gets appended to all target names
  8825.     inserted by makefile-insert-target.
  8826.     ":" or "::" are quite common values.
  8827.  
  8828. makefile-macro-assign:
  8829.    The string that gets appended to all macro names
  8830.    inserted by makefile-insert-macro.
  8831.    The normal value should be " = ", since this is what
  8832.    standard make expects. However, newer makes such as dmake
  8833.    allow a larger variety of different macro assignments, so you
  8834.    might prefer to use " += " or " := " .
  8835.  
  8836. makefile-tab-after-target-colon:
  8837.    If you want a TAB (instead of a space) to be appended after the
  8838.    target colon, then set this to a non-nil value.
  8839.  
  8840. makefile-browser-leftmost-column:
  8841.    Number of blanks to the left of the browser selection mark.
  8842.  
  8843. makefile-browser-cursor-column:
  8844.    Column in which the cursor is positioned when it moves
  8845.    up or down in the browser.
  8846.  
  8847. makefile-browser-selected-mark:
  8848.    String used to mark selected entries in the browser.
  8849.  
  8850. makefile-browser-unselected-mark:
  8851.    String used to mark unselected entries in the browser.
  8852.  
  8853. makefile-browser-auto-advance-after-selection-p:
  8854.    If this variable is set to a non-nil value the cursor
  8855.    will automagically advance to the next line after an item
  8856.    has been selected in the browser.
  8857.  
  8858. makefile-pickup-everything-picks-up-filenames-p:
  8859.    If this variable is set to a non-nil value then
  8860.    makefile-pickup-everything also picks up filenames as targets
  8861.    (i.e. it calls makefile-find-filenames-as-targets), otherwise
  8862.    filenames are omitted.
  8863.  
  8864. makefile-cleanup-continuations-p:
  8865.    If this variable is set to a non-nil value then makefile-mode
  8866.    will assure that no line in the file ends with a backslash
  8867.    (the continuation character) followed by any whitespace.
  8868.    This is done by silently removing the trailing whitespace, leaving
  8869.    the backslash itself intact.
  8870.    IMPORTANT: Please note that enabling this option causes makefile-mode
  8871.    to MODIFY A FILE WITHOUT YOUR CONFIRMATION when 'it seems necessary'.
  8872.  
  8873. makefile-browser-hook:
  8874.    A function or list of functions to be called just before the
  8875.    browser is entered. This is executed in the makefile buffer.
  8876.  
  8877. makefile-special-targets-list:
  8878.    List of special targets. You will be offered to complete
  8879.    on one of those in the minibuffer whenever you enter a "."
  8880.    at the beginning of a line in makefile-mode.
  8881. Fmake-command-summary
  8882. Make a summary of current key bindings in the buffer *Summary*.
  8883. Previous contents of that buffer are killed first.
  8884. Fmanual-entry
  8885. Get a Un*x manual page and put it in a buffer.
  8886. This command is the top-level command in the man package.  It runs a Un*x
  8887. command to retrieve and clean a manpage in the background and places the
  8888. results in a Man mode (manpage browsing) buffer.  See variable
  8889. `Man-notify' for what happens when the buffer is ready.
  8890. Universal argument ARG, is passed to `Man-getpage-in-background'.
  8891. Fmap-y-or-n-p
  8892. Ask a series of boolean questions.
  8893. Takes args PROMPTER ACTOR LIST, and optional args HELP and ACTION-ALIST.
  8894.  
  8895. LIST is a list of objects, or a function of no arguments to return the next
  8896. object or nil.
  8897.  
  8898. If PROMPTER is a string, the prompt is (format PROMPTER OBJECT).  If not
  8899. a string, PROMPTER is a function of one arg (an object from LIST), which
  8900. returns a string to be used as the prompt for that object.  If the return
  8901. value is not a string, it is eval'd to get the answer; it may be nil to
  8902. ignore the object, t to act on the object without asking the user, or a
  8903. form to do a more complex prompt.
  8904.  
  8905. ACTOR is a function of one arg (an object from LIST),
  8906. which gets called with each object that the user answers `yes' for.
  8907.  
  8908. If HELP is given, it is a list (OBJECT OBJECTS ACTION),
  8909. where OBJECT is a string giving the singular noun for an elt of LIST;
  8910. OBJECTS is the plural noun for elts of LIST, and ACTION is a transitive
  8911. verb describing ACTOR.  The default is ("object" "objects" "act on").
  8912.  
  8913. At the prompts, the user may enter y, Y, or SPC to act on that object;
  8914. n, N, or DEL to skip that object; ! to act on all following objects;
  8915. ESC or q to exit (skip all following objects); . (period) to act on the
  8916. current object and then exit; or \[help-command] to get help.
  8917.  
  8918. If ACTION-ALIST is given, it is an alist (KEY FUNCTION HELP) of extra keys
  8919. that will be accepted.  KEY is a character; FUNCTION is a function of one
  8920. arg (an object from LIST); HELP is a string.  When the user hits KEY,
  8921. FUNCTION is called.  If it returns non-nil, the object is considered
  8922. "acted upon", and the next object from LIST is processed.  If it returns
  8923. nil, the prompt is repeated for the same object.
  8924.  
  8925. Final optional argument NO-CURSOR-IN-ECHO-AREA non-nil says not to set
  8926. `cursor-in-echo-area' while prompting.
  8927.  
  8928. This function uses `query-replace-map' to define the standard responses,
  8929. but not all of the responses which `query-replace' understands
  8930. are meaningful here.
  8931.  
  8932. Returns the number of actions taken.
  8933. Fmh-rmail
  8934. Inc(orporate) new mail (no arg) or scan a MH mail box (arg given).
  8935. This front end uses the MH mail system, which uses different conventions
  8936. from the usual mail system.
  8937. Fmh-smail
  8938. Compose and send mail with the MH mail system.
  8939. Fconvert-mocklisp-buffer
  8940. Convert buffer of Mocklisp code to real Lisp that GNU Emacs can run.
  8941. Fmodula-2-mode
  8942. This is a mode intended to support program development in Modula-2.
  8943. All control constructs of Modula-2 can be reached by typing C-c
  8944. followed by the first character of the construct.
  8945. \<m2-mode-map>
  8946.   \[m2-begin] begin         \[m2-case] case
  8947.   \[m2-definition] definition    \[m2-else] else
  8948.   \[m2-for] for           \[m2-header] header
  8949.   \[m2-if] if            \[m2-module] module
  8950.   \[m2-loop] loop          \[m2-or] or
  8951.   \[m2-procedure] procedure     Control-c Control-w with
  8952.   \[m2-record] record        \[m2-stdio] stdio
  8953.   \[m2-type] type          \[m2-until] until
  8954.   \[m2-var] var           \[m2-while] while
  8955.   \[m2-export] export        \[m2-import] import
  8956.   \[m2-begin-comment] begin-comment \[m2-end-comment] end-comment
  8957.   \[suspend-emacs] suspend Emacs     \[m2-toggle] toggle
  8958.   \[m2-compile] compile           \[m2-next-error] next-error
  8959.   \[m2-link] link
  8960.  
  8961.    `m2-indent' controls the number of spaces for each indentation.
  8962.    `m2-compile-command' holds the command to compile a Modula-2 program.
  8963.    `m2-link-command' holds the command to link a Modula-2 program.
  8964. Fmpuz
  8965. Multiplication puzzle with GNU Emacs.
  8966. Fenable-command
  8967. Allow COMMAND to be executed without special confirmation from now on.
  8968. The user's .emacs file is altered so that this will apply
  8969. to future sessions.
  8970. Fdisable-command
  8971. Require special confirmation to execute COMMAND from now on.
  8972. The user's .emacs file is altered so that this will apply
  8973. to future sessions.
  8974. Fnroff-mode
  8975. Major mode for editing text intended for nroff to format.
  8976. \{nroff-mode-map}
  8977. Turning on Nroff mode runs `text-mode-hook', then `nroff-mode-hook'.
  8978. Also, try `nroff-electric-mode', for automatically inserting
  8979. closing requests for requests that are used in matched pairs.
  8980. Flist-options
  8981. Display a list of Emacs user options, with values and documentation.
  8982. Fedit-options
  8983. Edit a list of Emacs user option values.
  8984. Selects a buffer containing such a list,
  8985. in which there are commands to set the option values.
  8986. Type \[describe-mode] in that buffer for a list of commands.
  8987. Foutline-mode
  8988. Set major mode for editing outlines with selective display.
  8989. Headings are lines which start with asterisks: one for major headings,
  8990. two for subheadings, etc.  Lines not starting with asterisks are body lines. 
  8991.  
  8992. Body text or subheadings under a heading can be made temporarily
  8993. invisible, or visible again.  Invisible lines are attached to the end 
  8994. of the heading, so they move with it, if the line is killed and yanked
  8995. back.  A heading with text hidden under it is marked with an ellipsis (...).
  8996.  
  8997. Commands:\<outline-mode-map>
  8998. \[outline-next-visible-heading]   outline-next-visible-heading      move by visible headings
  8999. \[outline-previous-visible-heading]   outline-previous-visible-heading
  9000. \[outline-forward-same-level]   outline-forward-same-level        similar but skip subheadings
  9001. \[outline-backward-same-level]   outline-backward-same-level
  9002. \[outline-up-heading]   outline-up-heading            move from subheading to heading
  9003.  
  9004. M-x hide-body    make all text invisible (not headings).
  9005. M-x show-all    make everything in buffer visible.
  9006.  
  9007. The remaining commands are used when point is on a heading line.
  9008. They apply to some of the body or subheadings of that heading.
  9009. \[hide-subtree]   hide-subtree    make body and subheadings invisible.
  9010. \[show-subtree]   show-subtree    make body and subheadings visible.
  9011. \[show-children]   show-children    make direct subheadings visible.
  9012.          No effect on body, or subheadings 2 or more levels down.
  9013.          With arg N, affects subheadings N levels down.
  9014. M-x hide-entry       make immediately following body invisible.
  9015. M-x show-entry       make it visible.
  9016. M-x hide-leaves       make body under heading and under its subheadings invisible.
  9017.              The subheadings remain visible.
  9018. M-x show-branches  make all subheadings at all levels visible.
  9019.  
  9020. The variable `outline-regexp' can be changed to control what is a heading.
  9021. A line is a heading if `outline-regexp' matches something at the
  9022. beginning of the line.  The longer the match, the deeper the level.
  9023.  
  9024. Turning on outline mode calls the value of `text-mode-hook' and then of
  9025. `outline-mode-hook', if they are non-nil.
  9026. Foutline-minor-mode
  9027. Toggle Outline minor mode.
  9028. With arg, turn Outline minor mode on if arg is positive, off otherwise.
  9029. See the command `outline-mode' for more information on this mode.
  9030. Fperl-mode
  9031. Major mode for editing Perl code.
  9032. Expression and list commands understand all Perl brackets.
  9033. Tab indents for Perl code.
  9034. Comments are delimited with # ... \n.
  9035. Paragraphs are separated by blank lines only.
  9036. Delete converts tabs to spaces as it moves back.
  9037. \{perl-mode-map}
  9038. Variables controlling indentation style:
  9039.  perl-tab-always-indent
  9040.     Non-nil means TAB in Perl mode should always indent the current line,
  9041.     regardless of where in the line point is when the TAB command is used.
  9042.  perl-tab-to-comment
  9043.     Non-nil means that for lines which don't need indenting, TAB will
  9044.     either delete an empty comment, indent an existing comment, move 
  9045.     to end-of-line, or if at end-of-line already, create a new comment.
  9046.  perl-nochange
  9047.     Lines starting with this regular expression will not be auto-indented.
  9048.  perl-indent-level
  9049.     Indentation of Perl statements within surrounding block.
  9050.     The surrounding block's indentation is the indentation
  9051.     of the line on which the open-brace appears.
  9052.  perl-continued-statement-offset
  9053.     Extra indentation given to a substatement, such as the
  9054.     then-clause of an if or body of a while.
  9055.  perl-continued-brace-offset
  9056.     Extra indentation given to a brace that starts a substatement.
  9057.     This is in addition to perl-continued-statement-offset.
  9058.  perl-brace-offset
  9059.     Extra indentation for line if it starts with an open brace.
  9060.  perl-brace-imaginary-offset
  9061.     An open brace following other text is treated as if it were
  9062.     this far to the right of the start of its line.
  9063.  perl-label-offset
  9064.     Extra indentation for line that is a label.
  9065.  
  9066. Various indentation styles:       K&R  BSD  BLK  GNU  LW
  9067.   perl-indent-level                5    8    0    2    4
  9068.   perl-continued-statement-offset  5    8    4    2    4
  9069.   perl-continued-brace-offset      0    0    0    0   -4
  9070.   perl-brace-offset               -5   -8    0    0    0
  9071.   perl-brace-imaginary-offset      0    0    4    0    0
  9072.   perl-label-offset               -5   -8   -2   -2   -2
  9073.  
  9074. Turning on Perl mode calls the value of the variable perl-mode-hook with no 
  9075. args, if that value is non-nil.
  9076. Fpicture-mode
  9077. Switch to Picture mode, in which a quarter-plane screen model is used.
  9078. Printing characters replace instead of inserting themselves with motion
  9079. afterwards settable by these commands:
  9080.   C-c <      Move left after insertion.
  9081.   C-c >      Move right after insertion.
  9082.   C-c ^      Move up after insertion.
  9083.   C-c .      Move down after insertion.
  9084.   C-c `      Move northwest (nw) after insertion.
  9085.   C-c '      Move northeast (ne) after insertion.
  9086.   C-c /      Move southwest (sw) after insertion.
  9087.   C-c \   Move southeast (se) after insertion.
  9088. The current direction is displayed in the mode line.  The initial
  9089. direction is right.  Whitespace is inserted and tabs are changed to
  9090. spaces when required by movement.  You can move around in the buffer
  9091. with these commands:
  9092.   \[picture-move-down]      Move vertically to SAME column in previous line.
  9093.   \[picture-move-up]      Move vertically to SAME column in next line.
  9094.   \[picture-end-of-line]      Move to column following last non-whitespace character.
  9095.   \[picture-forward-column]      Move right inserting spaces if required.
  9096.   \[picture-backward-column]      Move left changing tabs to spaces if required.
  9097.   C-c C-f Move in direction of current picture motion.
  9098.   C-c C-b Move in opposite direction of current picture motion.
  9099.   Return  Move to beginning of next line.
  9100. You can edit tabular text with these commands:
  9101.   M-Tab      Move to column beneath (or at) next interesting character.
  9102.         `Indents' relative to a previous line.
  9103.   Tab      Move to next stop in tab stop list.
  9104.   C-c Tab Set tab stops according to context of this line.
  9105.         With ARG resets tab stops to default (global) value.
  9106.         See also documentation of variable    picture-tab-chars
  9107.         which defines "interesting character".  You can manually
  9108.         change the tab stop list with command \[edit-tab-stops].
  9109. You can manipulate text with these commands:
  9110.   C-d      Clear (replace) ARG columns after point without moving.
  9111.   C-c C-d Delete char at point - the command normally assigned to C-d.
  9112.   \[picture-backward-clear-column]  Clear (replace) ARG columns before point, moving back over them.
  9113.   \[picture-clear-line]      Clear ARG lines, advancing over them.     The cleared
  9114.         text is saved in the kill ring.
  9115.   \[picture-open-line]      Open blank line(s) beneath current line.
  9116. You can manipulate rectangles with these commands:
  9117.   C-c C-k Clear (or kill) a rectangle and save it.
  9118.   C-c C-w Like C-c C-k except rectangle is saved in named register.
  9119.   C-c C-y Overlay (or insert) currently saved rectangle at point.
  9120.   C-c C-x Like C-c C-y except rectangle is taken from named register.
  9121.   \[copy-rectangle-to-register]   Copies a rectangle to a register.
  9122.   \[advertised-undo]   Can undo effects of rectangle overlay commands
  9123.         commands if invoked soon enough.
  9124. You can return to the previous mode with:
  9125.   C-c C-c Which also strips trailing whitespace from every line.
  9126.         Stripping is suppressed by supplying an argument.
  9127.  
  9128. Entry to this mode calls the value of  picture-mode-hook  if non-nil.
  9129.  
  9130. Note that Picture mode commands will work outside of Picture mode, but
  9131. they are not defaultly assigned to keys.
  9132. Fprolog-mode
  9133. Major mode for editing Prolog code for Prologs.
  9134. Blank lines and `%%...' separate paragraphs.  `%'s start comments.
  9135. Commands:
  9136. \{prolog-mode-map}
  9137. Entry to this mode calls the value of `prolog-mode-hook'
  9138. if that value is non-nil.
  9139. Frun-prolog
  9140. Run an inferior Prolog process, input and output via buffer *prolog*.
  9141. Fdelete-rectangle
  9142. Delete (don't save) text in rectangle with point and mark as corners.
  9143. The same range of columns is deleted in each line starting with the line
  9144. where the region begins and ending with the line where the region ends.
  9145. Fdelete-extract-rectangle
  9146. Delete contents of rectangle and return it as a list of strings.
  9147. Arguments START and END are the corners of the rectangle.
  9148. The value is list of strings, one for each line of the rectangle.
  9149. Fextract-rectangle
  9150. Return contents of rectangle with corners at START and END.
  9151. Value is list of strings, one for each line of the rectangle.
  9152. Fkill-rectangle
  9153. Delete rectangle with corners at point and mark; save as last killed one.
  9154. Calling from program, supply two args START and END, buffer positions.
  9155. But in programs you might prefer to use `delete-extract-rectangle'.
  9156. Fyank-rectangle
  9157. Yank the last killed rectangle with upper left corner at point.
  9158. Finsert-rectangle
  9159. Insert text of RECTANGLE with upper left corner at point.
  9160. RECTANGLE's first line is inserted at point, its second
  9161. line is inserted at a point vertically under point, etc.
  9162. RECTANGLE should be a list of strings.
  9163. After this command, the mark is at the upper left corner
  9164. and point is at the lower right corner.
  9165. Fopen-rectangle
  9166. Blank out rectangle with corners at point and mark, shifting text right.
  9167. The text previously in the region is not overwritten by the blanks,
  9168. but instead winds up to the right of the rectangle.
  9169. Fstring-rectangle
  9170. Insert STRING on each line of the region-rectangle, shifting text right.
  9171. The left edge of the rectangle specifies the column for insertion.
  9172. This command does not delete or overwrite any existing text.
  9173.  
  9174. Called from a program, takes three args; START, END and STRING.
  9175. Fclear-rectangle
  9176. Blank out rectangle with corners at point and mark.
  9177. The text previously in the region is overwritten by the blanks.
  9178. When called from a program, requires two args which specify the corners.
  9179. Freposition-window
  9180. Make the current definition and/or comment visible.
  9181. Further invocations move it to the top of the window or toggle the
  9182. visibility of comments that precede it.
  9183.   Point is left unchanged unless prefix ARG is supplied.
  9184.   If the definition is fully onscreen, it is moved to the top of the
  9185. window.  If it is partly offscreen, the window is scrolled to get the
  9186. definition (or as much as will fit) onscreen, unless point is in a comment
  9187. which is also partly offscreen, in which case the scrolling attempts to get
  9188. as much of the comment onscreen as possible.
  9189.   Initially `reposition-window' attempts to make both the definition and
  9190. preceding comments visible.  Further invocations toggle the visibility of
  9191. the comment lines.
  9192.   If ARG is non-nil, point may move in order to make the whole defun
  9193. visible (if only part could otherwise be made so), to make the defun line
  9194. visible (if point is in code and it could not be made so, or if only
  9195. comments, including the first comment line, are visible), or to make the
  9196. first comment line visible (if point is in a comment).
  9197. Fresume-suspend-hook
  9198. Clear out the file used for transmitting args when Emacs resumes.
  9199. Fring-p
  9200. Returns t if X is a ring; nil otherwise.
  9201. Fmake-ring
  9202. Make a ring that can contain SIZE elements.
  9203. Vrlogin-program
  9204. *Name of program to invoke rlogin
  9205. Vrlogin-explicit-args
  9206. *List of arguments to pass to rlogin on the command line.
  9207. Vrlogin-mode-hook
  9208. *Hooks to run after setting current buffer to rlogin-mode.
  9209. Vrlogin-process-connection-type
  9210. *If non-`nil', use a pty for the local rlogin process.  
  9211. If `nil', use a pipe (if pipes are supported on the local system).  
  9212.  
  9213. Generally it is better not to waste ptys on systems which have a static
  9214. number of them.  On the other hand, some implementations of `rlogin' assume
  9215. a pty is being used, and errors will result from using a pipe instead.
  9216. Vrlogin-password-paranoia
  9217. *If non-`nil', query user for a password in the minibuffer when a Password: prompt appears.
  9218. It's also possible to selectively enter passwords without echoing them in
  9219. the minibuffer using the command `rlogin-password' explicitly.
  9220. Frlogin
  9221. Open a network login connection to HOST via the `rlogin' program.
  9222. Input is sent line-at-a-time to the remote connection.
  9223.  
  9224. Communication with HOST is recorded in a buffer *rlogin-HOST*.
  9225. If a prefix argument is given and the buffer *rlogin-HOST* already exists,
  9226. a new buffer with a different connection will be made. 
  9227.  
  9228. The variable `rlogin-program' contains the name of the actual program to
  9229. run.  It can be a relative or absolute path. 
  9230.  
  9231. The variable `rlogin-explicit-args' is a list of arguments to give to
  9232. the rlogin when starting.
  9233. Frlogin-with-args
  9234. Open a new rlogin connection to HOST, even if one already exists. 
  9235. String ARGS is given as arguments to the `rlogin' program, overriding the
  9236. value of `rlogin-explicit-args'.
  9237. Frlogin-password
  9238. Read a password and send it to an rlogin session.
  9239. For each character typed, a `*' is echoed in the minibuffer.
  9240. End with RET, LFD, or ESC.  DEL or C-h rubs out.  C-u kills line.
  9241. C-g aborts attempt to read and send password. 
  9242.  
  9243. Optional argument PROC is the process to which the password should be sent.
  9244. If not provided, send to the process in the current buffer.  This argument
  9245. is intended primarily for use by `rlogin-filter'.
  9246. Frlogin-mode
  9247. Set major-mode for rlogin sessions. 
  9248. If `rlogin-mode-hook' is set, run it.
  9249. Frlogin-delchar-or-send-Ctrl-D
  9250. Delete ARG characters forward, or send a C-d to process if at end of
  9251. buffer.
  9252. Vrmail-dont-reply-to-names
  9253. *A regexp specifying names to prune of reply to messages.
  9254. A value of nil means exclude your own name only.
  9255. Vrmail-default-dont-reply-to-names
  9256. A regular expression specifying part of the value of the default value of
  9257. the variable `rmail-dont-reply-to-names', for when the user does not set
  9258. `rmail-dont-reply-to-names' explicitly.  (The other part of the default
  9259. value is the user's name.)
  9260. It is useful to set this variable in the site customization file.
  9261. Vrmail-ignored-headers
  9262. *Gubbish headers one would rather not see.
  9263. Vrmail-delete-after-output
  9264. *Non-nil means automatically delete a message that is copied to a file.
  9265. Vrmail-primary-inbox-list
  9266. *List of files which are inboxes for user's primary mail file `~/RMAIL'.
  9267. `nil' means the default, which is ("/usr/spool/mail/$USER")
  9268. (the name varies depending on the operating system,
  9269. and the value of the environment variable MAIL overrides it).
  9270. Vrmail-mail-new-frame
  9271. *Non-nil means Rmail makes a new frame for composing outgoing mail.
  9272. Frmail
  9273. Read and edit incoming mail.
  9274. Moves messages into file named by  rmail-file-name  (a babyl format file)
  9275.  and edits that file in RMAIL Mode.
  9276. Type \[describe-mode] once editing that file, for a list of RMAIL commands.
  9277.  
  9278. May be called with filename as argument; then performs rmail editing on
  9279. that file, but does not copy any new mail into the file.
  9280. Frmail-mode
  9281. Rmail Mode is used by \<rmail-mode-map>\[rmail] for editing Rmail files.
  9282. All normal editing commands are turned off.
  9283. Instead, these commands are available:
  9284.  
  9285. \[rmail-beginning-of-message]    Move point to front of this message (same as \[beginning-of-buffer]).
  9286. \[scroll-up]    Scroll to next screen of this message.
  9287. \[scroll-down]    Scroll to previous screen of this message.
  9288. \[rmail-next-undeleted-message]    Move to Next non-deleted message.
  9289. \[rmail-previous-undeleted-message]    Move to Previous non-deleted message.
  9290. \[rmail-next-message]    Move to Next message whether deleted or not.
  9291. \[rmail-previous-message]    Move to Previous message whether deleted or not.
  9292. \[rmail-first-message]    Move to the first message in Rmail file.
  9293. \[rmail-last-message]    Move to the last message in Rmail file.
  9294. \[rmail-show-message]    Jump to message specified by numeric position in file.
  9295. \[rmail-search]    Search for string and show message it is found in.
  9296. \[rmail-delete-forward]    Delete this message, move to next nondeleted.
  9297. \[rmail-delete-backward]    Delete this message, move to previous nondeleted.
  9298. \[rmail-undelete-previous-message]    Undelete message.  Tries current message, then earlier messages
  9299.     till a deleted message is found.
  9300. \[rmail-edit-current-message]    Edit the current message.  \[rmail-cease-edit] to return to Rmail.
  9301. \[rmail-expunge]    Expunge deleted messages.
  9302. \[rmail-expunge-and-save]    Expunge and save the file.
  9303. \[rmail-quit]       Quit Rmail: expunge, save, then switch to another buffer.
  9304. \[save-buffer] Save without expunging.
  9305. \[rmail-get-new-mail]    Move new mail from system spool directory into this file.
  9306. \[rmail-mail]    Mail a message (same as \[mail-other-window]).
  9307. \[rmail-continue]    Continue composing outgoing message started before.
  9308. \[rmail-reply]    Reply to this message.  Like \[rmail-mail] but initializes some fields.
  9309. \[rmail-retry-failure]    Send this message again.  Used on a mailer failure message.
  9310. \[rmail-forward]    Forward this message to another user.
  9311. \[rmail-output-to-rmail-file]       Output this message to an Rmail file (append it).
  9312. \[rmail-output]    Output this message to a Unix-format mail file (append it).
  9313. \[rmail-input]    Input Rmail file.  Run Rmail on that file.
  9314. \[rmail-add-label]    Add label to message.  It will be displayed in the mode line.
  9315. \[rmail-kill-label]    Kill label.  Remove a label from current message.
  9316. \[rmail-next-labeled-message]   Move to Next message with specified label
  9317.           (label defaults to last one specified).
  9318.           Standard labels: filed, unseen, answered, forwarded, deleted.
  9319.           Any other label is present only if you add it with \[rmail-add-label].
  9320. \[rmail-previous-labeled-message]   Move to Previous message with specified label
  9321. \[rmail-summary]    Show headers buffer, with a one line summary of each message.
  9322. \[rmail-summary-by-labels]    Summarize only messages with particular label(s).
  9323. \[rmail-summary-by-recipients]   Summarize only messages with particular recipient(s).
  9324. \[rmail-summary-by-regexp]   Summarize only messages with particular regexp(s).
  9325. \[rmail-summary-by-topic]   Summarize only messages with subject line regexp(s).
  9326. \[rmail-toggle-header]    Toggle display of complete header.
  9327. Frmail-input
  9328. Run Rmail on file FILENAME.
  9329. Frot13-other-window
  9330. Display current buffer in rot 13 in another window.
  9331. Fsc-cite-original
  9332. Hook version of sc-cite.
  9333. This is callable from the various mail and news readers' reply
  9334. function according to the agreed upon standard. See \[sc-describe]
  9335. for more details.  Sc-cite-original does not do any yanking of the
  9336. original message but it does require a few things:
  9337.  
  9338.      1) The reply buffer is the current buffer.
  9339.  
  9340.      2) The original message has been yanked and inserted into the
  9341.         reply buffer.
  9342.  
  9343.      3) Verbose mail headers from the original message have been
  9344.         inserted into the reply buffer directly before the text of the
  9345.         original message.
  9346.  
  9347.      4) Point is at the beginning of the verbose headers.
  9348.  
  9349.      5) Mark is at the end of the body of text to be cited.
  9350. Fscheme-mode
  9351. Major mode for editing Scheme code.
  9352. Editing commands are similar to those of lisp-mode.
  9353.  
  9354. In addition, if an inferior Scheme process is running, some additional
  9355. commands will be defined, for evaluating expressions and controlling
  9356. the interpreter, and the state of the process will be displayed in the
  9357. modeline of all Scheme buffers.  The names of commands that interact
  9358. with the Scheme process start with "xscheme-".  For more information
  9359. see the documentation for xscheme-interaction-mode.
  9360.  
  9361. Commands:
  9362. Delete converts tabs to spaces as it moves back.
  9363. Blank lines separate paragraphs.  Semicolons start comments.
  9364. \{scheme-mode-map}
  9365. Entry to this mode calls the value of scheme-mode-hook
  9366. if that value is non-nil.
  9367. Fscribe-mode
  9368. Major mode for editing files of Scribe (a text formatter) source.
  9369. Scribe-mode is similar text-mode, with a few extra commands added.
  9370. \{scribe-mode-map}
  9371.  
  9372. Interesting variables:
  9373.  
  9374. scribe-fancy-paragraphs
  9375.   Non-nil makes Scribe mode use a different style of paragraph separation.
  9376.  
  9377. scribe-electric-quote
  9378.   Non-nil makes insert of double quote use `` or '' depending on context.
  9379.  
  9380. scribe-electric-parenthesis
  9381.   Non-nil makes an open-parenthesis char (one of `([<{')
  9382.   automatically insert its close if typed after an @Command form.
  9383. Vmail-self-blind
  9384. Non-nil means insert BCC to self in messages to be sent.
  9385. This is done when the message is initialized,
  9386. so you can remove or alter the BCC field to override the default.
  9387. Vmail-interactive
  9388. Non-nil means when sending a message wait for and display errors.
  9389. nil means let mailer mail back a message to report errors.
  9390. Vmail-yank-ignored-headers
  9391. Delete these headers from old message when it's inserted in a reply.
  9392. Vsend-mail-function
  9393. Function to call to send the current buffer as mail.
  9394. The headers are be delimited by a line which is `mail-header-separator'.
  9395. Vmail-header-separator
  9396. *Line used to separate headers from text in messages being composed.
  9397. Vmail-archive-file-name
  9398. *Name of file to write all outgoing messages in, or nil for none.
  9399. Do not use an rmail file here!  Instead, use its inbox file.
  9400. Vmail-signature
  9401. *Text inserted at end of mail buffer when a message is initialized.
  9402. If t, it means to insert the contents of the file `~/.signature'.
  9403. Fmail-mode
  9404. Major mode for editing mail to be sent.
  9405. Like Text Mode but with these additional commands:
  9406. C-c C-s  mail-send (send the message)    C-c C-c  mail-send-and-exit
  9407. C-c C-f  move to a header field (and create it if there isn't):
  9408.      C-c C-f C-t  move to To:    C-c C-f C-s  move to Subj:
  9409.      C-c C-f C-b  move to BCC:    C-c C-f C-c  move to CC:
  9410. C-c C-t  move to message text.
  9411. C-c C-y  mail-yank-original (insert current message, in Rmail).
  9412. C-c C-q  mail-fill-yanked-message (fill what was yanked).
  9413. C-c C-v  mail-sent-via (add a sent-via field for each To or CC).
  9414. Fmail
  9415. Edit a message to be sent.  Prefix arg means resume editing (don't erase).
  9416. When this function returns, the buffer `*mail*' is selected.
  9417. The value is t if the message was newly initialized; otherwise, nil.
  9418.  
  9419. By default, the signature file `~/.signature' is inserted at the end;
  9420. see the variable `mail-signature'.
  9421.  
  9422. \<mail-mode-map>
  9423. While editing message, type \[mail-send-and-exit] to send the message and exit.
  9424.  
  9425. Various special commands starting with C-c are available in sendmail mode
  9426. to move to message header fields:
  9427. \{mail-mode-map}
  9428.  
  9429. If `mail-self-blind' is non-nil, a BCC to yourself is inserted
  9430. when the message is initialized.
  9431.  
  9432. If `mail-default-reply-to' is non-nil, it should be an address (a string);
  9433. a Reply-to: field with that address is inserted.
  9434.  
  9435. If `mail-archive-file-name' is non-nil, an FCC field with that file name
  9436. is inserted.
  9437.  
  9438. If `mail-setup-hook' is bound, its value is called with no arguments
  9439. after the message is initialized.  It can add more default fields.
  9440.  
  9441. When calling from a program, the second through fifth arguments
  9442.  TO, SUBJECT, IN-REPLY-TO and CC specify if non-nil
  9443.  the initial contents of those header fields.
  9444.  These arguments should not have final newlines.
  9445. The sixth argument REPLYBUFFER is a buffer whose contents
  9446.  should be yanked if the user types C-c C-y.
  9447. The seventh argument ACTIONS is a list of actions to take
  9448.  if/when the message is sent.  Each action looks like (FUNCTION . ARGS);
  9449.  when the message is sent, we apply FUNCTION to ARGS.
  9450.  This is how Rmail arranges to mark messages `answered'.
  9451. Fmail-other-window
  9452. Like `mail' command, but display mail buffer in another window.
  9453. Fmail-other-frame
  9454. Like `mail' command, but display mail buffer in another frame.
  9455. Fserver-start
  9456. Allow this Emacs process to be a server for client processes.
  9457. This starts a server communications subprocess through which
  9458. client "editors" can send your editing commands to this Emacs job.
  9459. To use the server, set up the program `etc/emacsclient' in the
  9460. Emacs distribution as your standard "editor".
  9461.  
  9462. Prefix arg means just kill any existing server communications subprocess.
  9463. Fsgml-mode
  9464. Major mode for editing SGML.
  9465. Makes > display the matching <.  Makes / display matching /.
  9466. Use \[sgml-validate] to validate your document with an SGML parser.
  9467. Vshell-prompt-pattern
  9468. Regexp to match prompts in the inferior shell.
  9469. Defaults to "^[^#$%>\n]*[#$%>] *", which works pretty well.
  9470. This variable is used to initialise `comint-prompt-regexp' in the 
  9471. shell buffer.
  9472.  
  9473. The pattern should probably not match more than one line.  If it does,
  9474. shell-mode may become confused trying to distinguish prompt from input
  9475. on lines which don't start with a prompt.
  9476.  
  9477. This is a fine thing to set in your `.emacs' file.
  9478. Fshell
  9479. Run an inferior shell, with I/O through buffer *shell*.
  9480. If buffer exists but shell process is not running, make new shell.
  9481. If buffer exists and shell process is running, 
  9482.  just switch to buffer `*shell*'.
  9483. Program used comes from variable `explicit-shell-file-name',
  9484.  or (if that is nil) from the ESHELL environment variable,
  9485.  or else from SHELL if there is no ESHELL.
  9486. If a file `~/.emacs_SHELLNAME' exists, it is given as initial input
  9487.  (Note that this may lose due to a timing error if the shell
  9488.   discards input when it starts up.)
  9489. The buffer is put in Shell mode, giving commands for sending input
  9490. and controlling the subjobs of the shell.  See `shell-mode'.
  9491. See also the variable `shell-prompt-pattern'.
  9492.  
  9493. The shell file name (sans directories) is used to make a symbol name
  9494. such as `explicit-csh-args'.  If that symbol is a variable,
  9495. its value is used as a list of arguments when invoking the shell.
  9496. Otherwise, one argument `-i' is passed to the shell.
  9497.  
  9498. (Type \[describe-mode] in the shell buffer for a list of commands.)
  9499. Vcalendar-time-display-form
  9500. *The pseudo-pattern that governs the way a time of day is formatted.
  9501.  
  9502. A pseudo-pattern is a list of expressions that can involve the keywords
  9503. `12-hours', `24-hours', and `minutes',  all numbers in string form,
  9504. and `am-pm' and `time-zone',  both alphabetic strings.
  9505.  
  9506. For example, the form
  9507.  
  9508.   '(24-hours ":" minutes
  9509.     (if time-zone " (") time-zone (if time-zone ")"))
  9510.  
  9511. would give military-style times like `21:07 (UTC)'.
  9512. Vcalendar-latitude
  9513. *Latitude of `calendar-location-name' in degrees, + north, - south.
  9514. For example, 40.7 for New York City.
  9515. It may not be a good idea to set this in advance for your site;
  9516. if there may be users running Emacs at your site
  9517. who are physically located elsewhere, they would get the wrong
  9518. value and might not know how to override it.
  9519. Vcalendar-longitude
  9520. *Longitude of `calendar-location-name' in degrees, + east, - west.
  9521. For example, -74.0 for New York City.
  9522. It may not be a good idea to set this in advance for your site;
  9523. if there may be users running Emacs at your site
  9524. who are physically located elsewhere, they would get the wrong
  9525. value and might not know how to override it.
  9526. Vcalendar-location-name
  9527. *Expression evaluating to name of `calendar-longitude', calendar-latitude'.
  9528. Default value is just the latitude, longitude pair.
  9529. Fsunrise-sunset
  9530. Local time of sunrise and sunset for today.  Accurate to +/- 2 minutes.
  9531. If called with an optional prefix argument, prompts for date.
  9532.  
  9533. If called with an optional double prefix argument, prompts for longitude,
  9534. latitude, time zone, and date.
  9535.  
  9536. This function is suitable for execution in a .emacs file.
  9537. Fsolar-equinoxes-solstices
  9538. Date and time of equinoxes and solstices, if visible in the calendar window.
  9539. Requires floating point.
  9540. Fsort-lines
  9541. Sort lines in region alphabetically; argument means descending order.
  9542. Called from a program, there are three arguments:
  9543. REVERSE (non-nil means reverse order), BEG and END (region to sort).
  9544. Fsort-paragraphs
  9545. Sort paragraphs in region alphabetically; argument means descending order.
  9546. Called from a program, there are three arguments:
  9547. REVERSE (non-nil means reverse order), BEG and END (region to sort).
  9548. Fsort-pages
  9549. Sort pages in region alphabetically; argument means descending order.
  9550. Called from a program, there are three arguments:
  9551. REVERSE (non-nil means reverse order), BEG and END (region to sort).
  9552. Fsort-numeric-fields
  9553. Sort lines in region numerically by the ARGth field of each line.
  9554. Fields are separated by whitespace and numbered from 1 up.
  9555. Specified field must contain a number in each line of the region.
  9556. With a negative arg, sorts by the ARGth field counted from the right.
  9557. Called from a program, there are three arguments:
  9558. FIELD, BEG and END.  BEG and END specify region to sort.
  9559. If you want to sort floating-point numbers, try `sort-float-fields'.
  9560. Fsort-float-fields
  9561. Sort lines in region numerically by the ARGth field of each line.
  9562. Fields are separated by whitespace and numbered from 1 up.  Specified field
  9563. must contain a floating point number in each line of the region.  With a
  9564. negative arg, sorts by the ARGth field counted from the right.  Called from a
  9565. program, there are three arguments: FIELD, BEG and END.  BEG and END specify
  9566. region to sort.
  9567. Fsort-fields
  9568. Sort lines in region lexicographically by the ARGth field of each line.
  9569. Fields are separated by whitespace and numbered from 1 up.
  9570. With a negative arg, sorts by the ARGth field counted from the right.
  9571. Called from a program, there are three arguments:
  9572. FIELD, BEG and END.  BEG and END specify region to sort.
  9573. Fsort-regexp-fields
  9574. Sort the region lexicographically as specified by RECORD-REGEXP and KEY.
  9575. RECORD-REGEXP specifies the textual units which should be sorted.
  9576.   For example, to sort lines RECORD-REGEXP would be "^.*$"
  9577. KEY specifies the part of each record (ie each match for RECORD-REGEXP)
  9578.   is to be used for sorting.
  9579.   If it is "\digit" then the digit'th "\(...\)" match field from
  9580.   RECORD-REGEXP is used.
  9581.   If it is "\&" then the whole record is used.
  9582.   Otherwise, it is a regular-expression for which to search within the record.
  9583. If a match for KEY is not found within a record then that record is ignored.
  9584.  
  9585. With a negative prefix arg sorts in reverse order.
  9586.  
  9587. For example: to sort lines in the region by the first word on each line
  9588.  starting with the letter "f",
  9589.  RECORD-REGEXP would be "^.*$" and KEY would be "\=\<f\w*\>"
  9590. Fsort-columns
  9591. Sort lines in region alphabetically by a certain range of columns.
  9592. For the purpose of this command, the region includes
  9593. the entire line that point is in and the entire line the mark is in.
  9594. The column positions of point and mark bound the range of columns to sort on.
  9595. A prefix argument means sort into reverse order.
  9596.  
  9597. Note that `sort-columns' rejects text that contains tabs,
  9598. because tabs could be split across the specified columns
  9599. and it doesn't know how to handle that.  Also, when possible,
  9600. it uses the `sort' utility program, which doesn't understand tabs.
  9601. Use \[untabify] to convert tabs to spaces before sorting.
  9602. Freverse-region
  9603. Reverse the order of lines in a region.
  9604. From a program takes two point or marker arguments, BEG and END.
  9605. Fspell-buffer
  9606. Check spelling of every word in the buffer.
  9607. For each incorrect word, you are asked for the correct spelling
  9608. and then put into a query-replace to fix some or all occurrences.
  9609. If you do not want to change a word, just give the same word
  9610. as its "correct" spelling; then the query replace is skipped.
  9611. Fspell-word
  9612. Check spelling of word at or before point.
  9613. If it is not correct, ask user for the correct spelling
  9614. and `query-replace' the entire buffer to substitute it.
  9615. Fspell-region
  9616. Like `spell-buffer' but applies only to region.
  9617. Used in a program, applies from START to END.
  9618. DESCRIPTION is an optional string naming the unit being checked:
  9619. for example, "word".
  9620. Fspell-string
  9621. Check spelling of string supplied as argument.
  9622. Fspook
  9623. Adds that special touch of class to your outgoing mail.
  9624. Fsnarf-spooks
  9625. Return a vector containing the lines from `spook-phrases-file'.
  9626. Funtabify
  9627. Convert all tabs in region to multiple spaces, preserving columns.
  9628. Called non-interactively, the region is specified by arguments
  9629. START and END, rather than by the position of point and mark.
  9630. The variable `tab-width' controls the spacing of tab stops.
  9631. Ftabify
  9632. Convert multiple spaces in region to tabs when possible.
  9633. A group of spaces is partially replaced by tabs
  9634. when this can be done without changing the column they end at.
  9635. Called non-interactively, the region is specified by arguments
  9636. START and END, rather than by the position of point and mark.
  9637. The variable `tab-width' controls the spacing of tab stops.
  9638. Ftar-mode
  9639. Major mode for viewing a tar file as a dired-like listing of its contents.
  9640. You can move around using the usual cursor motion commands. 
  9641. Letters no longer insert themselves.
  9642. Type `e' to pull a file out of the tar file and into its own buffer.
  9643. Type `c' to copy an entry from the tar file into another file on disk.
  9644.  
  9645. If you edit a sub-file of this archive (as with the `e' command) and 
  9646. save it with Control-x Control-s, the contents of that buffer will be 
  9647. saved back into the tar-file buffer; in this way you can edit a file 
  9648. inside of a tar archive without extracting it and re-archiving it.
  9649.  
  9650. See also: variables `tar-update-datestamp' and `tar-anal-blocksize'.
  9651. \{tar-mode-map}
  9652. Ftelnet
  9653. Open a network login connection to host named HOST (a string).
  9654. Communication with HOST is recorded in a buffer *HOST-telnet*.
  9655. Normally input is edited in Emacs and sent a line at a time.
  9656. Frsh
  9657. Open a network login connection to host named HOST (a string).
  9658. Communication with HOST is recorded in a buffer *HOST-rsh*.
  9659. Normally input is edited in Emacs and sent a line at a time.
  9660. Fterminal-emulator
  9661. Under a display-terminal emulator in BUFFER, run PROGRAM on arguments ARGS.
  9662. ARGS is a list of argument-strings.  Remaining arguments are WIDTH and HEIGHT.
  9663. BUFFER's contents are made an image of the display generated by that program,
  9664. and any input typed when BUFFER is the current Emacs buffer is sent to that
  9665. program an keyboard input.
  9666.  
  9667. Interactively, BUFFER defaults to "*terminal*" and PROGRAM and ARGS
  9668. are parsed from an input-string using your usual shell.
  9669. WIDTH and HEIGHT are determined from the size of the current window
  9670. -- WIDTH will be one less than the window's width, HEIGHT will be its height.
  9671.  
  9672. To switch buffers and leave the emulator, or to give commands
  9673. to the emulator itself (as opposed to the program running under it),
  9674. type Control-^.  The following character is an emulator command.
  9675. Type Control-^ twice to send it to the subprogram.
  9676. This escape character may be changed using the variable `terminal-escape-char'.
  9677.  
  9678. `Meta' characters may not currently be sent through the terminal emulator.
  9679.  
  9680. Here is a list of some of the variables which control the behaviour
  9681. of the emulator -- see their documentation for more information:
  9682. terminal-escape-char, terminal-scrolling, terminal-more-processing,
  9683. terminal-redisplay-interval.
  9684.  
  9685. This function calls the value of terminal-mode-hook if that exists
  9686. and is non-nil after the terminal buffer has been set up and the
  9687. subprocess started.
  9688.  
  9689. Presently with `termcap' only; if somebody sends us code to make this
  9690. work with `terminfo' we will try to use it.
  9691. Vtex-shell-file-name
  9692. *If non-nil, is file name to use for the subshell in which TeX is run.
  9693. Vtex-directory
  9694. *Directory in which temporary files are left.
  9695. You can make this /tmp if your TEXINPUTS has no relative directories in it
  9696. and you don't try to apply \[tex-region] or \[tex-buffer] when there are
  9697. \input commands with relative directories.
  9698. Vtex-offer-save
  9699. *If non-nil, ask about saving modified buffers before \[tex-file] is run.
  9700. Vtex-run-command
  9701. *Command used to run TeX subjob.
  9702. If this string contains an asterisk (*), it will be replaced by the
  9703. filename; if not, the name of the file, preceded by blank, will be added to
  9704. this string.
  9705. Vlatex-run-command
  9706. *Command used to run LaTeX subjob.
  9707. If this string contains an asterisk (*), it will be replaced by the
  9708. filename; if not, the name of the file, preceded by blank, will be added to
  9709. this string.
  9710. Vlatex-block-names
  9711. *User defined LaTeX block names.
  9712. Combined with `standard-latex-block-names' for minibuffer completion.
  9713. Vslitex-run-command
  9714. *Command used to run SliTeX subjob.
  9715. If this string contains an asterisk (*), it will be replaced by the
  9716. filename; if not, the name of the file, preceded by blank, will be added to
  9717. this string.
  9718. Vtex-bibtex-command
  9719. *Command used by `tex-bibtex-file' to gather bibliographic data.
  9720. If this string contains an asterisk (*), it will be replaced by the
  9721. filename; if not, the name of the file, preceded by blank, will be added to
  9722. this string.
  9723. Vtex-dvi-print-command
  9724. *Command used by \[tex-print] to print a .dvi file.
  9725. If this string contains an asterisk (*), it will be replaced by the
  9726. filename; if not, the name of the file, preceded by blank, will be added to
  9727. this string.
  9728. Vtex-alt-dvi-print-command
  9729. *Command used by \[tex-print] with a prefix arg to print a .dvi file.
  9730. If this string contains an asterisk (*), it will be replaced by the
  9731. filename; if not, the name of the file, preceded by blank, will be added to
  9732. this string.
  9733.  
  9734. If two printers are not enough of a choice, you can define the value
  9735. of tex-alt-dvi-print-command to be an expression that asks what you want;
  9736. for example,
  9737.  
  9738.     (setq tex-alt-dvi-print-command
  9739.          '(format "lpr -P%s" (read-string "Use printer: ")))
  9740.  
  9741. would tell \[tex-print] with a prefix argument to ask you which printer to
  9742. use.
  9743. Vtex-dvi-view-command
  9744. *Command used by \[tex-view] to display a .dvi file.
  9745. If this string contains an asterisk (*), it will be replaced by the
  9746. filename; if not, the name of the file, preceded by blank, will be added to
  9747. this string.
  9748.  
  9749. This can be set conditionally so that the previewer used is suitable for the
  9750. window system being used.  For example,
  9751.  
  9752.     (setq tex-dvi-view-command
  9753.           (if (eq window-system 'x) "xdvi" "dvi2tty * | cat -s"))
  9754.  
  9755. would tell \[tex-view] use xdvi under X windows and to use dvi2tty
  9756. otherwise.
  9757. Vtex-show-queue-command
  9758. *Command used by \[tex-show-print-queue] to show the print queue.
  9759. Should show the queue(s) that \[tex-print] puts jobs on.
  9760. Vtex-default-mode
  9761. *Mode to enter for a new file that might be either TeX or LaTeX.
  9762. This variable is used when it can't be determined whether the file
  9763. is plain TeX or LaTeX or what because the file contains no commands.
  9764. Normally set to either 'plain-tex-mode or 'latex-mode.
  9765. Vtex-open-quote
  9766. *String inserted by typing \[tex-insert-quote] to open a quotation.
  9767. Vtex-close-quote
  9768. *String inserted by typing \[tex-insert-quote] to close a quotation.
  9769. Ftex-mode
  9770. Major mode for editing files of input for TeX, LaTeX, or SliTeX.
  9771. Tries to determine (by looking at the beginning of the file) whether
  9772. this file is for plain TeX, LaTeX, or SliTeX and calls plain-tex-mode,
  9773. latex-mode, or slitex-mode, respectively.  If it cannot be determined,
  9774. such as if there are no commands in the file, the value of tex-default-mode
  9775. is used.
  9776. Fplain-tex-mode
  9777. Major mode for editing files of input for plain TeX.
  9778. Makes $ and } display the characters they match.
  9779. Makes " insert `` when it seems to be the beginning of a quotation,
  9780. and '' when it appears to be the end; it inserts " only after a \.
  9781.  
  9782. Use \[tex-region] to run TeX on the current region, plus a "header"
  9783. copied from the top of the file (containing macro definitions, etc.),
  9784. running TeX under a special subshell.  \[tex-buffer] does the whole buffer.
  9785. \[tex-file] saves the buffer and then processes the file.
  9786. \[tex-print] prints the .dvi file made by any of these.
  9787. \[tex-view] previews the .dvi file made by any of these.
  9788. \[tex-bibtex-file] runs bibtex on the file of the current buffer.
  9789.  
  9790. Use \[validate-tex-buffer] to check buffer for paragraphs containing
  9791. mismatched $'s or braces.
  9792.  
  9793. Special commands:
  9794. \{tex-mode-map}
  9795.  
  9796. Mode variables:
  9797. tex-run-command
  9798.     Command string used by \[tex-region] or \[tex-buffer].
  9799. tex-directory
  9800.     Directory in which to create temporary files for TeX jobs
  9801.     run by \[tex-region] or \[tex-buffer].
  9802. tex-dvi-print-command
  9803.     Command string used by \[tex-print] to print a .dvi file.
  9804. tex-alt-dvi-print-command
  9805.     Alternative command string used by \[tex-print] (when given a prefix
  9806.     argument) to print a .dvi file.
  9807. tex-dvi-view-command
  9808.     Command string used by \[tex-view] to preview a .dvi file.
  9809. tex-show-queue-command
  9810.     Command string used by \[tex-show-print-queue] to show the print
  9811.     queue that \[tex-print] put your job on.
  9812.  
  9813. Entering Plain-tex mode calls the value of `text-mode-hook', then the value
  9814. of `tex-mode-hook', and then the value of `plain-tex-mode-hook'.  When the
  9815. special subshell is initiated, the value of `tex-shell-hook' is called.
  9816. Flatex-mode
  9817. Major mode for editing files of input for LaTeX.
  9818. Makes $ and } display the characters they match.
  9819. Makes " insert `` when it seems to be the beginning of a quotation,
  9820. and '' when it appears to be the end; it inserts " only after a \.
  9821.  
  9822. Use \[tex-region] to run LaTeX on the current region, plus the preamble
  9823. copied from the top of the file (containing \documentstyle, etc.),
  9824. running LaTeX under a special subshell.  \[tex-buffer] does the whole buffer.
  9825. \[tex-file] saves the buffer and then processes the file.
  9826. \[tex-print] prints the .dvi file made by any of these.
  9827. \[tex-view] previews the .dvi file made by any of these.
  9828. \[tex-bibtex-file] runs bibtex on the file of the current buffer.
  9829.  
  9830. Use \[validate-tex-buffer] to check buffer for paragraphs containing
  9831. mismatched $'s or braces.
  9832.  
  9833. Special commands:
  9834. \{tex-mode-map}
  9835.  
  9836. Mode variables:
  9837. latex-run-command
  9838.     Command string used by \[tex-region] or \[tex-buffer].
  9839. tex-directory
  9840.     Directory in which to create temporary files for LaTeX jobs
  9841.     run by \[tex-region] or \[tex-buffer].
  9842. tex-dvi-print-command
  9843.     Command string used by \[tex-print] to print a .dvi file.
  9844. tex-alt-dvi-print-command
  9845.     Alternative command string used by \[tex-print] (when given a prefix
  9846.     argument) to print a .dvi file.
  9847. tex-dvi-view-command
  9848.     Command string used by \[tex-view] to preview a .dvi file.
  9849. tex-show-queue-command
  9850.     Command string used by \[tex-show-print-queue] to show the print
  9851.     queue that \[tex-print] put your job on.
  9852.  
  9853. Entering Latex mode calls the value of text-mode-hook, then the value of
  9854. tex-mode-hook, and then the value of latex-mode-hook.  When the special
  9855. subshell is initiated, the value of tex-shell-hook is called.
  9856. Ftexinfo-format-buffer
  9857. Process the current buffer as texinfo code, into an Info file.
  9858. The Info file output is generated in a buffer visiting the Info file
  9859. names specified in the @setfilename command.
  9860.  
  9861. Non-nil argument (prefix, if interactive) means don't make tag table
  9862. and don't split the file if large.  You can use Info-tagify and
  9863. Info-split to do these manually.
  9864. Ftexinfo-format-region
  9865. Convert the current region of the Texinfo file to Info format.
  9866. This lets you see what that part of the file will look like in Info.
  9867. The command is bound to \[texinfo-format-region].  The text that is
  9868. converted to Info is stored in a temporary buffer.
  9869. Ftexinfo-mode
  9870. Major mode for editing Texinfo files.
  9871.  
  9872.   It has these extra commands:
  9873. \{texinfo-mode-map}
  9874.  
  9875.   These are files that are used as input for TeX to make printed manuals
  9876. and also to be turned into Info files with \[makeinfo-buffer] or
  9877. the `makeinfo' program.  These files must be written in a very restricted and
  9878. modified version of TeX input format.
  9879.  
  9880.   Editing commands are like text-mode except that the syntax table is
  9881. set up so expression commands skip Texinfo bracket groups.  To see
  9882. what the Info version of a region of the Texinfo file will look like,
  9883. use \[makeinfo-region], which runs `makeinfo' on the current region.
  9884.  
  9885.   You can show the structure of a Texinfo file with \[texinfo-show-structure].
  9886. This command shows the structure of a Texinfo file by listing the
  9887. lines with the @-sign commands for @chapter, @section, and the like.
  9888. These lines are displayed in another window called the *Occur* window.
  9889. In that window, you can position the cursor over one of the lines and
  9890. use \[occur-mode-goto-occurrence], to jump to the corresponding spot
  9891. in the Texinfo file.
  9892.  
  9893.   In addition, Texinfo mode provides commands that insert various
  9894. frequently used @-sign commands into the buffer.  You can use these
  9895. commands to save keystrokes.  And you can insert balanced braces with
  9896. \[texinfo-insert-braces] and later use the command \[up-list] to
  9897. move forward past the closing brace.
  9898.  
  9899. Also, Texinfo mode provides functions for automatically creating or
  9900. updating menus and node pointers.  These functions
  9901.  
  9902.   * insert the `Next', `Previous' and `Up' pointers of a node,
  9903.   * insert or update the menu for a section, and
  9904.   * create a master menu for a Texinfo source file.
  9905.  
  9906. Here are the functions:
  9907.  
  9908.     texinfo-update-node                \[texinfo-update-node]
  9909.     texinfo-every-node-update          \[texinfo-every-node-update]
  9910.     texinfo-sequential-node-update 
  9911.  
  9912.     texinfo-make-menu                  \[texinfo-make-menu]
  9913.     texinfo-all-menus-update           \[texinfo-all-menus-update]
  9914.     texinfo-master-menu
  9915.  
  9916.     texinfo-indent-menu-description (column &optional region-p)
  9917.  
  9918. The `texinfo-column-for-description' variable specifies the column to
  9919. which menu descriptions are indented. 
  9920.  
  9921. Passed an argument (a prefix argument, if interactive), the
  9922. `texinfo-update-node' and `texinfo-make-menu' functions do their jobs
  9923. in the region.
  9924.  
  9925. To use the updating commands, you must structure your Texinfo file
  9926. hierarchically, such that each `@node' line, with the exception of the
  9927. Top node, is accompanied by some kind of section line, such as an
  9928. `@chapter' or `@section' line.
  9929.  
  9930. If the file has a `top' node, it must be called `top' or `Top' and
  9931. be the first node in the file.
  9932.  
  9933. Entering Texinfo mode calls the value of text-mode-hook, and then the
  9934. value of texinfo-mode-hook.
  9935. Ftexinfo-update-node
  9936. Without any prefix argument, update the node in which point is located.
  9937. Non-nil argument (prefix, if interactive) means update the nodes in the
  9938. marked region.
  9939.  
  9940. The functions for creating or updating nodes and menus, and their
  9941. keybindings, are:
  9942.  
  9943.     texinfo-update-node (&optional region-p)    \[texinfo-update-node]
  9944.     texinfo-every-node-update ()                \[texinfo-every-node-update]
  9945.     texinfo-sequential-node-update (&optional region-p)
  9946.  
  9947.     texinfo-make-menu (&optional region-p)      \[texinfo-make-menu]
  9948.     texinfo-all-menus-update ()                 \[texinfo-all-menus-update]
  9949.     texinfo-master-menu ()
  9950.  
  9951.     texinfo-indent-menu-description (column &optional region-p)
  9952.  
  9953. The `texinfo-column-for-description' variable specifies the column to
  9954. which menu descriptions are indented. Its default value is 32.
  9955. Ftexinfo-every-node-update
  9956. Update every node in a Texinfo file.
  9957. Ftexinfo-sequential-node-update
  9958. Update one node (or many) in a Texinfo file with sequential pointers.
  9959.  
  9960. This function causes the `Next' or `Previous' pointer to point to the
  9961. immediately preceding or following node, even if it is at a higher or
  9962. lower hierarchical level in the document.  Continually pressing `n' or
  9963. `p' takes you straight through the file.
  9964.  
  9965. Without any prefix argument, update the node in which point is located.
  9966. Non-nil argument (prefix, if interactive) means update the nodes in the
  9967. marked region.
  9968.  
  9969. This command makes it awkward to navigate among sections and
  9970. subsections; it should be used only for those documents that are meant
  9971. to be read like a novel rather than a reference, and for which the
  9972. Info `g*' command is inadequate.
  9973. Vdisplay-time-day-and-date
  9974. *Non-nil means \[display-time] should display day and date as well as time.
  9975. Fdisplay-time
  9976. Display current time, load level, and mail flag in mode line of each buffer.
  9977. Updates automatically every minute.
  9978. If `display-time-day-and-date' is non-nil, the current day and date
  9979. are displayed as well.
  9980. After each update, `display-time-hook' is run with `run-hooks'.
  9981. Ftime-stamp
  9982. Update the time stamp string in the buffer.
  9983. Only does its thing if the variable  time-stamp-active  is non-nil.
  9984. Typically used on  write-file-hooks  for automatic time-stamping.
  9985. The format of the time stamp is determined by the variable
  9986. time-stamp-format.  The first  time-stamp-line-limit  lines of the
  9987. buffer (normally 8) are searched for the time stamp template,
  9988. and if it is found, a new time stamp is written into it.
  9989. Frun-at-time
  9990. Run a function at a time, and optionally on a regular interval.
  9991. Arguments are TIME, REPEAT, FUNCTION &rest ARGS.
  9992. TIME, a string, can be specified absolutely or relative to now.
  9993. TIME can also be an integer, a number of seconds.
  9994. REPEAT, an integer number of seconds, is the interval on which to repeat
  9995. the call to the function.  If REPEAT is nil, call it just once.
  9996.  
  9997. Absolute times may be specified in a wide variety of formats;
  9998. Something of the form `HOUR:MIN:SEC TIMEZONE MONTH/DAY/YEAR', where
  9999. all fields are numbers, works; the format used by the Unix `date'
  10000. command works too.
  10001.  
  10002. Relative times may be specified as a series of numbers followed by units:
  10003.   1 min             denotes one minute from now.
  10004.   min            does too.
  10005.   1 min 5 sec        denotes 65 seconds from now.
  10006.   1 min 2 sec 3 hour 4 day 5 week 6 fortnight 7 month 8 year
  10007.             denotes the sum of all the given durations from now.
  10008. Ftpu-edt-on
  10009. Turn on TPU/edt emulation.
  10010. Ftq-create
  10011. Create and return a transaction queue communicating with PROCESS.
  10012. PROCESS should be a subprocess capable of sending and receiving
  10013. streams of bytes.  It may be a local process, or it may be connected
  10014. to a tcp server on another machine.
  10015. Vtrace-buffer
  10016. *Trace output will by default go to that buffer.
  10017. Ftrace-function
  10018. Traces FUNCTION with trace output going to BUFFER.
  10019. For every call of FUNCTION Lisp-style trace messages that display argument
  10020. and return values will be inserted into BUFFER. This function generates the
  10021. trace advice for FUNCTION and activates it together with any other advice
  10022. there might be!! The trace BUFFER will popup whenever FUNCTION is called.
  10023. Do not use this to trace functions that switch buffers or do any other
  10024. display oriented stuff, use `trace-function-background' instead.
  10025. Ftrace-function-background
  10026. Traces FUNCTION with trace output going quietly to BUFFER.
  10027. For every call of FUNCTION Lisp-style trace messages that display argument
  10028. and return values will be inserted into BUFFER. This function generates the
  10029. trace advice for FUNCTION and activates it together with any other advice
  10030. there might be!! Trace output will quietly go to BUFFER without changing
  10031. the window or buffer configuration at all.
  10032. Vtc-mode-map
  10033. Keymap for commands for two-column mode.
  10034. Ftc-two-columns
  10035. Split current window vertically for two-column editing.
  10036.  
  10037. When called the first time, associates a buffer with the current
  10038. buffer.  Both buffers are put in two-column minor mode and
  10039. tc-mode-hook gets called on both.  These buffers remember
  10040. about one another, even when renamed.
  10041.  
  10042. When called again, restores the screen layout with the current buffer
  10043. first and the associated buffer to it's right.
  10044.  
  10045. If you include long lines, i.e which will span both columns (eg.
  10046. source code), they should be in what will be the first column, with
  10047. the associated buffer having empty lines next to them.
  10048.  
  10049. You have the following commands at your disposal:
  10050.  
  10051. \[tc-two-columns]   Rearrange screen
  10052. \[tc-associate-buffer]   Reassociate buffer after changing major mode
  10053. \[tc-scroll-up]   Scroll both buffers up by a screenfull
  10054. \[tc-scroll-down]   Scroll both buffers down by a screenful
  10055. \[tc-scroll-line]   Scroll both buffers up by one or more lines
  10056. \[tc-recenter]   Recenter and realign other buffer
  10057. \[shrink-window-horizontally], \[enlarge-window-horizontally]   Shrink, enlarge current column
  10058. \[tc-associated-buffer]   Switch to associated buffer
  10059. \[tc-merge]   Merge both buffers
  10060.  
  10061. These keybindings can be customized in your ~/.emacs by `tc-prefix'
  10062. and `tc-mode-map'.
  10063.  
  10064. The appearance of the screen can be customized by the variables
  10065. `tc-window-width', `tc-beyond-fill-column',
  10066. `tc-mode-line-format' and `truncate-partial-width-windows'.
  10067. Ftc-associate-buffer
  10068. Associate another buffer with this one in two-column minor mode.
  10069. Can also be used to associate a just previously visited file, by
  10070. accepting the proposed default buffer.
  10071.  
  10072. See  \[tc-two-columns]  and  `lisp/two-column.el'  for further details.
  10073. Ftc-split
  10074. Unmerge a two-column text into two buffers in two-column minor mode.
  10075. The text is unmerged at the cursor's column which becomes the local
  10076. value of `tc-window-width'.  Only lines that have the ARG same
  10077. preceding characters at that column get split.  The ARG preceding
  10078. characters without any leading whitespace become the local value for
  10079. `tc-separator'.  This way lines that continue across both
  10080. columns remain untouched in the first buffer.
  10081.  
  10082. This function can be used with a prototype line, to set up things as
  10083. you like them.  You write the first line of each column with the
  10084. separator you like and then unmerge that line.  E.g.:
  10085.  
  10086. First column's text    sSs  Second columns text
  10087.                \___/\
  10088.             /    \
  10089.    5 character Separator      You type  M-5 \[tc-split]  with the point here
  10090.  
  10091. See  \[tc-two-columns]  and  `lisp/two-column.el'  for further details.
  10092. Ftc-dissociate
  10093. Turn off two-column minor mode in current and associated buffer.
  10094. If the associated buffer is unmodified and empty, it is killed.
  10095. Ftc-merge
  10096. Merges the associated buffer with the current buffer.
  10097. They get merged at the column, which is the value of
  10098. `tc-window-width', i.e. usually at the vertical window
  10099. separator.  This separator gets replaced with white space.  Beyond
  10100. that the value of gets inserted on merged lines.  The two columns are
  10101. thus pasted side by side, in a single text.  If the other buffer is
  10102. not displayed to the left of this one, then this one becomes the left
  10103. column.
  10104.  
  10105. If you want `tc-separator' on empty lines in the second column,
  10106. you should put just one space in them.  In the final result, you can strip
  10107. off trailing spaces with \[beginning-of-buffer] \[replace-regexp] [ SPC TAB ] + $ RET RET
  10108. Ftc-associated-buffer
  10109. Switch to associated buffer.
  10110. Ftc-scroll-line
  10111. Scroll current window upward by ARG lines.
  10112. The associated window gets scrolled to the same line.
  10113. Ftc-scroll-up
  10114. Scroll current window upward by ARG screens.
  10115. The associated window gets scrolled to the same line.
  10116. Ftc-scroll-down
  10117. Scroll current window downward by ARG screens.
  10118. The associated window gets scrolled to the same line.
  10119. Ftc-recenter
  10120. Center point in window.  With ARG, put point on line ARG.
  10121. This counts from bottom if ARG is negative.  The associated window
  10122. gets scrolled to the same line.
  10123. Funderline-region
  10124. Underline all nonblank characters in the region.
  10125. Works by overstriking underscores.
  10126. Called from program, takes two arguments START and END
  10127. which specify the range to operate on.
  10128. Fununderline-region
  10129. Remove all underlining (overstruck underscores) in the region.
  10130. Called from program, takes two arguments START and END
  10131. which specify the range to operate on.
  10132. Fbatch-unrmail
  10133. Convert Rmail files to mailbox files.
  10134. Specify the input Rmail file names as command line arguments.
  10135. For each Rmail file, the corresponding output file name
  10136. is made by adding `.mail' at the end.
  10137. For example, invoke `emacs -batch -f batch-unrmail RMAIL'.
  10138. Funrmail
  10139. Convert Rmail file FILE to mailbox-format file TO-FILE.
  10140. Vreplace-copying-with
  10141. *If non-nil, replace copying notices with this file.
  10142. Fupdate-copyright
  10143. Update the copyright notice at the beginning of the buffer
  10144. to indicate the current year.  If optional arg REPLACE is given
  10145. (interactively, with prefix arg) replace the years in the notice
  10146. rather than adding the current year after them.
  10147. If `replace-copying-with' is set, the copying permissions following the
  10148. copyright are replaced as well.
  10149.  
  10150. If optional third argument ASK is non-nil, the user is prompted for whether
  10151. or not to update the copyright.  If optional fourth argument ASK-YEAR is
  10152. non-nil, the user is prompted for whether or not to replace the year rather
  10153. than adding to it.
  10154. Fask-to-update-copyright
  10155. If the current buffer contains a copyright notice that is out of date,
  10156. ask the user if it should be updated with `update-copyright' (which see).
  10157. Put this on write-file-hooks.
  10158. Fask-user-about-lock
  10159. Ask user what to do when he wants to edit FILE but it is locked by USER.
  10160. This function has a choice of three things to do:
  10161.   do (signal 'buffer-file-locked (list FILE USER))
  10162.     to refrain from editing the file
  10163.   return t (grab the lock on the file)
  10164.   return nil (edit the file even though it is locked).
  10165. You can rewrite it to use any criterion you like to choose which one to do.
  10166. Fask-user-about-supersession-threat
  10167. Ask a user who is about to modify an obsolete buffer what to do.
  10168. This function has two choices: it can return, in which case the modification
  10169. of the buffer will proceed, or it can (signal 'file-supersession (file)),
  10170. in which case the proposed buffer modification will not be made.
  10171.  
  10172. You can rewrite this to use any criterion you like to choose which one to do.
  10173. The buffer in question is current when this function is called.
  10174. Vvc-checkin-hook
  10175. *List of functions called after a checkin is done.  See `run-hooks'.
  10176. Fvc-next-action
  10177. Do the next logical checkin or checkout operation on the current file.
  10178.    If the file is not already registered, this registers it for version
  10179. control and then retrieves a writable, locked copy for editing.
  10180.    If the file is registered and not locked by anyone, this checks out
  10181. a writable and locked file ready for editing.
  10182.    If the file is checked out and locked by the calling user, this
  10183. first checks to see if the file has changed since checkout.  If not,
  10184. it performs a revert.
  10185.    If the file has been changed, this pops up a buffer for entry
  10186. of a log message; when the message has been entered, it checks in the
  10187. resulting changes along with the log message as change commentary.  If
  10188. the variable `vc-keep-workfiles' is non-nil (which is its default), a
  10189. read-only copy of the changed file is left in place afterwards.
  10190.    If the file is registered and locked by someone else, you are given
  10191. the option to steal the lock.
  10192.    If you call this from within a VC dired buffer with no files marked,
  10193. it will operate on the file in the current line.
  10194.    If you call this from within a VC dired buffer, and one or more
  10195. files are marked, it will accept a log message and then operate on
  10196. each one.  The log message will be used as a comment for any register
  10197. or checkin operations, but ignored when doing checkouts.  Attempted
  10198. lock steals will raise an error.
  10199. Fvc-register
  10200. Register the current file into your version-control system.
  10201. Fvc-diff
  10202. Display diffs between file versions.
  10203. Normally this compares the current file and buffer with the most recent 
  10204. checked in version of that file.  This uses no arguments.
  10205. With a prefix argument, it reads the file name to use
  10206. and two version designators specifying which versions to compare.
  10207. Fvc-version-other-window
  10208. Visit version REV of the current buffer in another window.
  10209. If the current buffer is named `F', the version is named `F.~REV~'.
  10210. If `F.~REV~' already exists, it is used instead of being re-created.
  10211. Fvc-insert-headers
  10212. Insert headers in a file for use with your version-control system.
  10213. Headers desired are inserted at the start of the buffer, and are pulled from
  10214. the variable `vc-header-alist'.
  10215. Fvc-directory
  10216. Show version-control status of all files under the current directory.
  10217. Fvc-create-snapshot
  10218. Make a snapshot called NAME.
  10219. The snapshot is made from all registered files at or below the current
  10220. directory.  For each file, the version level of its latest
  10221. version becomes part of the named configuration.
  10222. Fvc-retrieve-snapshot
  10223. Retrieve the snapshot called NAME.
  10224. This function fails if any files are locked at or below the current directory
  10225. Otherwise, all registered files are checked out (unlocked) at their version
  10226. levels in the snapshot.
  10227. Fvc-print-log
  10228. List the change log of the current buffer in a window.
  10229. Fvc-revert-buffer
  10230. Revert the current buffer's file back to the latest checked-in version.
  10231. This asks for confirmation if the buffer contents are not identical
  10232. to that version.
  10233. Fvc-cancel-version
  10234. Get rid of most recently checked in version of this file.
  10235. A prefix argument means do not revert the buffer afterwards.
  10236. Fvc-update-change-log
  10237. Find change log file and add entries from recent RCS logs.
  10238. The mark is left at the end of the text prepended to the change log.
  10239. With prefix arg of C-u, only find log entries for the current buffer's file.
  10240. With any numeric prefix arg, find log entries for all files currently visited.
  10241. Otherwise, find log entries for all registered files in the default directory.
  10242. From a program, any arguments are passed to the `rcs2log' script.
  10243. Fvi-mode
  10244. Major mode that acts like the `vi' editor.
  10245. The purpose of this mode is to provide you the combined power of vi (namely,
  10246. the "cross product" effect of commands and repeat last changes) and Emacs.
  10247.  
  10248. This command redefines nearly all keys to look like vi commands.
  10249. It records the previous major mode, and any vi command for input
  10250. (`i', `a', `s', etc.) switches back to that mode.
  10251. Thus, ordinary Emacs (in whatever major mode you had been using)
  10252. is "input" mode as far as vi is concerned.
  10253.  
  10254. To get back into vi from "input" mode, you must issue this command again.
  10255. Therefore, it is recommended that you assign it to a key.
  10256.  
  10257. Major differences between this mode and real vi :
  10258.  
  10259. * Limitations and unsupported features
  10260.   - Search patterns with line offset (e.g. /pat/+3 or /pat/z.) are
  10261.     not supported.
  10262.   - Ex commands are not implemented; try ':' to get some hints.
  10263.   - No line undo (i.e. the 'U' command), but multi-undo is a standard feature.
  10264.  
  10265. * Modifications
  10266.   - The stopping positions for some point motion commands (word boundary,
  10267.     pattern search) are slightly different from standard 'vi'.
  10268.     Also, no automatic wrap around at end of buffer for pattern searching.
  10269.   - Since changes are done in two steps (deletion then insertion), you need
  10270.     to undo twice to completely undo a change command.  But this is not needed
  10271.     for undoing a repeated change command.
  10272.   - No need to set/unset 'magic', to search for a string with regular expr
  10273.     in it just put a prefix arg for the search commands.  Replace cmds too.
  10274.   - ^R is bound to incremental backward search, so use ^L to redraw screen.
  10275.  
  10276. * Extensions
  10277.   - Some standard (or modified) Emacs commands were integrated, such as
  10278.     incremental search, query replace, transpose objects, and keyboard macros.
  10279.   - In command state, ^X links to the 'ctl-x-map', and ESC can be linked to
  10280.     esc-map or set undefined.  These can give you the full power of Emacs.
  10281.   - See vi-com-map for those keys that are extensions to standard vi, e.g.
  10282.     `vi-name-last-change-or-macro', `vi-verify-spelling', `vi-locate-def',
  10283.     `vi-mark-region', and 'vi-quote-words'.  Some of them are quite handy.
  10284.   - Use \[vi-switch-mode] to switch among different modes quickly.
  10285.   
  10286. Syntax table and abbrevs while in vi mode remain as they were in Emacs.
  10287. Fview-file
  10288. View FILE in View mode, returning to previous buffer when done.
  10289. The usual Emacs commands are not available; instead,
  10290. a special set of commands (mostly letters and punctuation)
  10291. are defined for moving around in the buffer.
  10292. Space scrolls forward, Delete scrolls backward.
  10293. For list of all View commands, type ? or h while viewing.
  10294.  
  10295. This command runs the normal hook `view-hook'.
  10296. Fview-file-other-window
  10297. View FILE in View mode in other window.
  10298. Return to previous buffer when done.
  10299. The usual Emacs commands are not available; instead,
  10300. a special set of commands (mostly letters and punctuation)
  10301. are defined for moving around in the buffer.
  10302. Space scrolls forward, Delete scrolls backward.
  10303. For list of all View commands, type ? or h while viewing.
  10304.  
  10305. This command runs the normal hook `view-hook'.
  10306. Fview-buffer
  10307. View BUFFER in View mode, returning to previous buffer when done.
  10308. The usual Emacs commands are not available; instead,
  10309. a special set of commands (mostly letters and punctuation)
  10310. are defined for moving around in the buffer.
  10311. Space scrolls forward, Delete scrolls backward.
  10312. For list of all View commands, type ? or h while viewing.
  10313.  
  10314. This command runs the normal hook `view-hook'.
  10315. Fview-buffer-other-window
  10316. View BUFFER in View mode in another window,
  10317. returning to original buffer when done *only* if 
  10318. prefix argument NOT-RETURN is nil (which is the default).
  10319.  
  10320. The usual Emacs commands are not available in View mode; instead,
  10321. a special set of commands (mostly letters and punctuation)
  10322. are defined for moving around in the buffer.
  10323. Space scrolls forward, Delete scrolls backward.
  10324. For list of all View commands, type ? or h while viewing.
  10325.  
  10326. This command runs the normal hook `view-hook'.
  10327. Fview-mode
  10328. Major mode for viewing text but not editing it.
  10329. Letters do not insert themselves.  Instead these commands are provided.
  10330. Most commands take prefix arguments.  Commands dealing with lines
  10331. default to "scroll size" lines (initially size of window).
  10332. Search commands default to a repeat count of one.
  10333. M-< or <    move to beginning of buffer.
  10334. M-> or >    move to end of buffer.
  10335. C-v or Space    scroll forward lines.
  10336. M-v or DEL    scroll backward lines.
  10337. CR or LF    scroll forward one line (backward with prefix argument).
  10338. z        like Space except set number of lines for further
  10339.            scrolling commands to scroll by.
  10340. C-u and Digits    provide prefix arguments.  `-' denotes negative argument.
  10341. =        prints the current line number.
  10342. g        goes to line given by prefix argument.
  10343. / or M-C-s    searches forward for regular expression
  10344. \ or M-C-r    searches backward for regular expression.
  10345. n        searches forward for last regular expression.
  10346. p        searches backward for last regular expression.
  10347. C-@ or .    set the mark.
  10348. x        exchanges point and mark.
  10349. C-s or s    do forward incremental search.
  10350. C-r or r    do reverse incremental search.
  10351. @ or '        return to mark and pops mark ring.
  10352.           Mark ring is pushed at start of every
  10353.           successful search and when jump to line to occurs.
  10354.           The mark is set on jump to buffer start or end.
  10355. ? or h        provide help message (list of commands).
  10356. \[Helper-help]        provides help (list of commands or description of a command).
  10357. C-n        moves down lines vertically.
  10358. C-p        moves upward lines vertically.
  10359. C-l        recenters the screen.
  10360. q or C-c    exit view-mode and return to previous buffer.
  10361.  
  10362. Entry to this mode runs the normal hook `view-hook'.
  10363.  
  10364. \{view-mode-map}
  10365. Fvip-mode
  10366. Turn on VIP emulation of VI.
  10367. Fwordstar-mode
  10368. Major mode with WordStar-like key bindings.
  10369.  
  10370. BUGS:
  10371.  - Help menus with WordStar commands (C-j just calls help-for-help)
  10372.    are not implemented
  10373.  - Options for search and replace
  10374.  - Show markers (C-k h) is somewhat strange
  10375.  - Search and replace (C-q a) is only available in forward direction
  10376.  
  10377. No key bindings beginning with ESC are installed, they will work
  10378. Emacs-like.
  10379.  
  10380. The key bindings are:
  10381.  
  10382.   C-a        backward-word
  10383.   C-b        fill-paragraph
  10384.   C-c        scroll-up-line
  10385.   C-d        forward-char
  10386.   C-e        previous-line
  10387.   C-f        forward-word
  10388.   C-g        delete-char
  10389.   C-h        backward-char
  10390.   C-i        indent-for-tab-command
  10391.   C-j        help-for-help
  10392.   C-k        ordstar-C-k-map
  10393.   C-l        ws-repeat-search
  10394.   C-n        open-line
  10395.   C-p        quoted-insert
  10396.   C-r        scroll-down-line
  10397.   C-s        backward-char
  10398.   C-t        kill-word
  10399.   C-u        keyboard-quit
  10400.   C-v        overwrite-mode
  10401.   C-w        scroll-down
  10402.   C-x        next-line
  10403.   C-y        kill-complete-line
  10404.   C-z        scroll-up
  10405.  
  10406.   C-k 0        ws-set-marker-0
  10407.   C-k 1        ws-set-marker-1
  10408.   C-k 2        ws-set-marker-2
  10409.   C-k 3        ws-set-marker-3
  10410.   C-k 4        ws-set-marker-4
  10411.   C-k 5        ws-set-marker-5
  10412.   C-k 6        ws-set-marker-6
  10413.   C-k 7        ws-set-marker-7
  10414.   C-k 8        ws-set-marker-8
  10415.   C-k 9        ws-set-marker-9
  10416.   C-k b        ws-begin-block
  10417.   C-k c        ws-copy-block
  10418.   C-k d        save-buffers-kill-emacs
  10419.   C-k f        find-file
  10420.   C-k h        ws-show-markers
  10421.   C-k i        ws-indent-block
  10422.   C-k k        ws-end-block
  10423.   C-k p        ws-print-block
  10424.   C-k q        kill-emacs
  10425.   C-k r        insert-file
  10426.   C-k s        save-some-buffers
  10427.   C-k t        ws-mark-word
  10428.   C-k u        ws-exdent-block
  10429.   C-k C-u    keyboard-quit
  10430.   C-k v        ws-move-block
  10431.   C-k w        ws-write-block
  10432.   C-k x        kill-emacs
  10433.   C-k y        ws-delete-block
  10434.  
  10435.   C-o c        center-line
  10436.   C-o b        switch-to-buffer
  10437.   C-o j        justify-current-line
  10438.   C-o k        kill-buffer
  10439.   C-o l        list-buffers
  10440.   C-o m        auto-fill-mode
  10441.   C-o r        set-fill-column
  10442.   C-o C-u    keyboard-quit
  10443.   C-o wd    delete-other-windows
  10444.   C-o wh    split-window-horizontally
  10445.   C-o wo    other-window
  10446.   C-o wv    split-window-vertically
  10447.  
  10448.   C-q 0        ws-find-marker-0
  10449.   C-q 1        ws-find-marker-1
  10450.   C-q 2        ws-find-marker-2
  10451.   C-q 3        ws-find-marker-3
  10452.   C-q 4        ws-find-marker-4
  10453.   C-q 5        ws-find-marker-5
  10454.   C-q 6        ws-find-marker-6
  10455.   C-q 7        ws-find-marker-7
  10456.   C-q 8        ws-find-marker-8
  10457.   C-q 9        ws-find-marker-9
  10458.   C-q a        ws-query-replace
  10459.   C-q b        ws-to-block-begin
  10460.   C-q c        end-of-buffer
  10461.   C-q d        end-of-line
  10462.   C-q f        ws-search
  10463.   C-q k        ws-to-block-end
  10464.   C-q l        ws-undo
  10465.   C-q p        ws-last-cursorp
  10466.   C-q r        beginning-of-buffer
  10467.   C-q C-u    keyboard-quit
  10468.   C-q w        ws-last-error
  10469.   C-q y        ws-kill-eol
  10470.   C-q DEL    ws-kill-bol
  10471.  
  10472. Frun-scheme
  10473. Run an inferior Scheme process.
  10474. Output goes to the buffer `*scheme*'.
  10475. With argument, asks for a command line.
  10476. Fyow
  10477. Return or display a random Zippy quotation.
  10478. Fpsychoanalyze-pinhead
  10479. Zippy goes to the analyst.
  10480. Fmap-y-or-n-p
  10481. Ask a series of boolean questions.
  10482. Takes args PROMPTER ACTOR LIST, and optional args HELP and ACTION-ALIST.
  10483.  
  10484. LIST is a list of objects, or a function of no arguments to return the next
  10485. object or nil.
  10486.  
  10487. If PROMPTER is a string, the prompt is (format PROMPTER OBJECT).  If not
  10488. a string, PROMPTER is a function of one arg (an object from LIST), which
  10489. returns a string to be used as the prompt for that object.  If the return
  10490. value is not a string, it is eval'd to get the answer; it may be nil to
  10491. ignore the object, t to act on the object without asking the user, or a
  10492. form to do a more complex prompt.
  10493.  
  10494. ACTOR is a function of one arg (an object from LIST),
  10495. which gets called with each object that the user answers `yes' for.
  10496.  
  10497. If HELP is given, it is a list (OBJECT OBJECTS ACTION),
  10498. where OBJECT is a string giving the singular noun for an elt of LIST;
  10499. OBJECTS is the plural noun for elts of LIST, and ACTION is a transitive
  10500. verb describing ACTOR.  The default is ("object" "objects" "act on").
  10501.  
  10502. At the prompts, the user may enter y, Y, or SPC to act on that object;
  10503. n, N, or DEL to skip that object; ! to act on all following objects;
  10504. ESC or q to exit (skip all following objects); . (period) to act on the
  10505. current object and then exit; or \[help-command] to get help.
  10506.  
  10507. If ACTION-ALIST is given, it is an alist (KEY FUNCTION HELP) of extra keys
  10508. that will be accepted.  KEY is a character; FUNCTION is a function of one
  10509. arg (an object from LIST); HELP is a string.  When the user hits KEY,
  10510. FUNCTION is called.  If it returns non-nil, the object is considered
  10511. "acted upon", and the next object from LIST is processed.  If it returns
  10512. nil, the prompt is repeated for the same object.
  10513.  
  10514. Final optional argument NO-CURSOR-IN-ECHO-AREA non-nil says not to set
  10515. `cursor-in-echo-area' while prompting.
  10516.  
  10517. This function uses `query-replace-map' to define the standard responses,
  10518. but not all of the responses which `query-replace' understands
  10519. are meaningful here.
  10520.  
  10521. Returns the number of actions taken.
  10522. Fforward-page
  10523. Move forward to page boundary.  With arg, repeat, or go back if negative.
  10524. A page boundary is any line whose beginning matches the regexp
  10525. `page-delimiter'.
  10526. Fbackward-page
  10527. Move backward to page boundary.  With arg, repeat, or go fwd if negative.
  10528. A page boundary is any line whose beginning matches the regexp
  10529. `page-delimiter'.
  10530. Fmark-page
  10531. Put mark at end of page, point at beginning.
  10532. A numeric arg specifies to move forward or backward by that many pages,
  10533. thus marking a page other than the one point was originally in.
  10534. Fnarrow-to-page
  10535. Make text outside current page invisible.
  10536. A numeric arg specifies to move forward or backward by that many pages,
  10537. thus showing a page other than the one point was originally in.
  10538. Fcount-lines-page
  10539. Report number of lines on current page, and how many are before or after point.
  10540. Fwhat-page
  10541. Print page and line number of point.
  10542. Vparagraph-start
  10543. *Regexp for beginning of a line that starts OR separates paragraphs.
  10544. This regexp should match lines that separate paragraphs
  10545. and should also match lines that start a paragraph
  10546. (and are part of that paragraph).
  10547. The variable `paragraph-separate' specifies how to distinguish
  10548. lines that start paragraphs from lines that separate them.
  10549. Vparagraph-separate
  10550. *Regexp for beginning of a line that separates paragraphs.
  10551. If you change this, you may have to change paragraph-start also.
  10552. Vsentence-end
  10553. *Regexp describing the end of a sentence.
  10554. All paragraph boundaries also end sentences, regardless.
  10555.  
  10556. In order to be recognized as the end of a sentence, the ending period,
  10557. question mark, or exclamation point must be followed by two spaces,
  10558. unless it's inside some sort of quotes or parenthesis.
  10559. Vpage-delimiter
  10560. *Regexp describing line-beginnings that separate pages.
  10561. Vparagraph-ignore-fill-prefix
  10562. Non-nil means the paragraph commands are not affected by `fill-prefix'.
  10563. This is desirable in modes where blank lines are the paragraph delimiters.
  10564. Fforward-paragraph
  10565. Move forward to end of paragraph.
  10566. With arg N, do it N times; negative arg -N means move forward N paragraphs.
  10567.  
  10568. A line which `paragraph-start' matches either separates paragraphs
  10569. (if `paragraph-separate' matches it also) or is the first line of a paragraph.
  10570. A paragraph end is the beginning of a line which is not part of the paragraph
  10571. to which the end of the previous line belongs, or the end of the buffer.
  10572. Fbackward-paragraph
  10573. Move backward to start of paragraph.
  10574. With arg N, do it N times; negative arg -N means move forward N paragraphs.
  10575.  
  10576. A paragraph start is the beginning of a line which is a
  10577. `first-line-of-paragraph' or which is ordinary text and follows a
  10578. paragraph-separating line; except: if the first real line of a
  10579. paragraph is preceded by a blank line, the paragraph starts at that
  10580. blank line.
  10581.  
  10582. See `forward-paragraph' for more information.
  10583. Fmark-paragraph
  10584. Put point at beginning of this paragraph, mark at end.
  10585. The paragraph marked is the one that contains point or follows point.
  10586. Fkill-paragraph
  10587. Kill forward to end of paragraph.
  10588. With arg N, kill forward to Nth end of paragraph;
  10589. negative arg -N means kill backward to Nth start of paragraph.
  10590. Fbackward-kill-paragraph
  10591. Kill back to start of paragraph.
  10592. With arg N, kill back to Nth start of paragraph;
  10593. negative arg -N means kill forward to Nth end of paragraph.
  10594. Ftranspose-paragraphs
  10595. Interchange this (or next) paragraph with previous one.
  10596. Fforward-sentence
  10597. Move forward to next `sentence-end'.  With argument, repeat.
  10598. With negative argument, move backward repeatedly to `sentence-beginning'.
  10599.  
  10600. The variable `sentence-end' is a regular expression that matches ends of
  10601. sentences.  Also, every paragraph boundary terminates sentences as well.
  10602. Fbackward-sentence
  10603. Move backward to start of sentence.  With arg, do it arg times.
  10604. See `forward-sentence' for more information.
  10605. Fkill-sentence
  10606. Kill from point to end of sentence.
  10607. With arg, repeat; negative arg -N means kill back to Nth start of sentence.
  10608. Fbackward-kill-sentence
  10609. Kill back from point to start of sentence.
  10610. With arg, repeat, or kill forward to Nth end of sentence if negative arg -N.
  10611. Fmark-end-of-sentence
  10612. Put mark at end of sentence.  Arg works as in `forward-sentence'.
  10613. Ftranspose-sentences
  10614. Interchange this (next) and previous sentence.
  10615. Vregister-alist
  10616. Alist of elements (NAME . CONTENTS), one for each Emacs register.
  10617. NAME is a character (a number).  CONTENTS is a string, number,
  10618. frame configuration, mark or list.
  10619. A list of strings represents a rectangle.
  10620. A list of the form (file . NAME) represents the file named NAME.
  10621. Fget-register
  10622. Return contents of Emacs register named CHAR, or nil if none.
  10623. Fset-register
  10624. Set contents of Emacs register named CHAR to VALUE.  Returns VALUE.
  10625. See the documentation of the variable `register-alist' for possible VALUE.
  10626. Fpoint-to-register
  10627. Store current location of point in register REGISTER.
  10628. With prefix argument, store current frame configuration.
  10629. Use \[jump-to-register] to go to that location or restore that configuration.
  10630. Argument is a character, naming the register.
  10631. Fwindow-configuration-to-register
  10632. Store the window configuration of the selected frame in register REGISTER.
  10633. Use \[jump-to-register] to restore the configuration.
  10634. Argument is a character, naming the register.
  10635. Fframe-configuration-to-register
  10636. Store the window configuration of all frames in register REGISTER.
  10637. Use \[jump-to-register] to restore the configuration.
  10638. Argument is a character, naming the register.
  10639. Fjump-to-register
  10640. Move point to location stored in a register.
  10641. If the register contains a file name, find that file.
  10642.  (To put a file name in a register, you must use `set-register'.)
  10643. If the register contains a window configuration (one frame) or a frame
  10644. configuration (all frames), restore that frame or all frames accordingly.
  10645. First argument is a character, naming the register.
  10646. Optional second arg non-nil (interactively, prefix argument) says to
  10647. delete any existing frames that the frame configuration doesn't mention.
  10648. (Otherwise, these frames are iconified.)
  10649. Fview-register
  10650. Display what is contained in register named REGISTER.
  10651. REGISTER is a character.
  10652. Finsert-register
  10653. Insert contents of register REG.  REG is a character.
  10654. Normally puts point before and mark after the inserted text.
  10655. If optional second arg is non-nil, puts mark before and point after.
  10656. Interactively, second arg is non-nil if prefix arg is supplied.
  10657. Fcopy-to-register
  10658. Copy region into register REG.  With prefix arg, delete as well.
  10659. Called from program, takes four args: REG, START, END and DELETE-FLAG.
  10660. START and END are buffer positions indicating what to copy.
  10661. Fappend-to-register
  10662. Append region to text in register REG.  With prefix arg, delete as well.
  10663. Called from program, takes four args: REG, START, END and DELETE-FLAG.
  10664. START and END are buffer positions indicating what to append.
  10665. Fprepend-to-register
  10666. Prepend region to text in register REG.  With prefix arg, delete as well.
  10667. Called from program, takes four args: REG, START, END and DELETE-FLAG.
  10668. START and END are buffer positions indicating what to prepend.
  10669. Fcopy-rectangle-to-register
  10670. Copy rectangular region into register REG.  With prefix arg, delete as well.
  10671. Called from program, takes four args: REG, START, END and DELETE-FLAG.
  10672. START and END are buffer positions giving two corners of rectangle.
  10673. Vcase-replace
  10674. *Non-nil means query-replace should preserve case in replacements.
  10675. Fquery-replace
  10676. Replace some occurrences of FROM-STRING with TO-STRING.
  10677. As each match is found, the user must type a character saying
  10678. what to do with it.  For directions, type \[help-command] at that time.
  10679.  
  10680. Preserves case in each replacement if  case-replace  and  case-fold-search
  10681. are non-nil and FROM-STRING has no uppercase letters.
  10682. Third arg DELIMITED (prefix arg if interactive) non-nil means replace
  10683. only matches surrounded by word boundaries.
  10684.  
  10685. To customize possible responses, change the "bindings" in `query-replace-map'.
  10686. Fquery-replace-regexp
  10687. Replace some things after point matching REGEXP with TO-STRING.
  10688. As each match is found, the user must type a character saying
  10689. what to do with it.  For directions, type \[help-command] at that time.
  10690.  
  10691. Preserves case in each replacement if  case-replace  and  case-fold-search
  10692. are non-nil and REGEXP has no uppercase letters.
  10693. Third arg DELIMITED (prefix arg if interactive) non-nil means replace
  10694. only matches surrounded by word boundaries.
  10695. In TO-STRING, \& means insert what matched REGEXP,
  10696. and \=\<n> means insert what matched <n>th \(...\) in REGEXP.
  10697. Fmap-query-replace-regexp
  10698. Replace some matches for REGEXP with various strings, in rotation.
  10699. The second argument TO-STRINGS contains the replacement strings, separated
  10700. by spaces.  This command works like `query-replace-regexp' except
  10701. that each successive replacement uses the next successive replacement string,
  10702. wrapping around from the last such string to the first.
  10703.  
  10704. Non-interactively, TO-STRINGS may be a list of replacement strings.
  10705.  
  10706. A prefix argument N says to use each replacement string N times
  10707. before rotating to the next.
  10708. Freplace-string
  10709. Replace occurrences of FROM-STRING with TO-STRING.
  10710. Preserve case in each match if `case-replace' and `case-fold-search'
  10711. are non-nil and FROM-STRING has no uppercase letters.
  10712. Third arg DELIMITED (prefix arg if interactive) non-nil means replace
  10713. only matches surrounded by word boundaries.
  10714.  
  10715. This function is usually the wrong thing to use in a Lisp program.
  10716. What you probably want is a loop like this:
  10717.   (while (search-forward OLD-STRING nil t)
  10718.     (replace-match REPLACEMENT nil t))
  10719. which will run faster and will not set the mark or print anything.
  10720. Freplace-regexp
  10721. Replace things after point matching REGEXP with TO-STRING.
  10722. Preserve case in each match if case-replace and case-fold-search
  10723. are non-nil and REGEXP has no uppercase letters.
  10724. Third arg DELIMITED (prefix arg if interactive) non-nil means replace
  10725. only matches surrounded by word boundaries.
  10726. In TO-STRING, \& means insert what matched REGEXP,
  10727. and \=\<n> means insert what matched <n>th \(...\) in REGEXP.
  10728.  
  10729. This function is usually the wrong thing to use in a Lisp program.
  10730. What you probably want is a loop like this:
  10731.   (while (re-search-forward REGEXP nil t)
  10732.     (replace-match REPLACEMENT nil nil))
  10733. which will run faster and will not set the mark or print anything.
  10734. Vregexp-history
  10735. History list for some commands that read regular expressions.
  10736. Fkeep-lines
  10737. Delete all lines except those containing matches for REGEXP.
  10738. A match split across lines preserves all the lines it lies in.
  10739. Applies to all lines after point.
  10740. Fflush-lines
  10741. Delete lines containing matches for REGEXP.
  10742. If a match is split across lines, all the lines it lies in are deleted.
  10743. Applies to lines after point.
  10744. Fhow-many
  10745. Print number of matches for REGEXP following point.
  10746. Foccur-mode
  10747. Major mode for output from \[occur].
  10748. Move point to one of the occurrences in this buffer,
  10749. then use \[occur-mode-goto-occurrence] to go to the same occurrence
  10750. in the buffer that the occurrences were found in.
  10751. \{occur-mode-map}
  10752. Foccur-mode-goto-occurrence
  10753. Go to the line this occurrence was found in, in the buffer it was found in.
  10754. Vlist-matching-lines-default-context-lines
  10755. *Default number of context lines to include around a `list-matching-lines'
  10756. match.  A negative number means to include that many lines before the match.
  10757. A positive number means to include that many lines both before and after.
  10758. Foccur
  10759. Show all lines in the current buffer containing a match for REGEXP.
  10760.  
  10761. If a match spreads across multiple lines, all those lines are shown.
  10762.  
  10763. Each line is displayed with NLINES lines before and after, or -NLINES
  10764. before if NLINES is negative.
  10765. NLINES defaults to `list-matching-lines-default-context-lines'.
  10766. Interactively it is the prefix arg.
  10767.  
  10768. The lines are shown in a buffer named `*Occur*'.
  10769. It serves as a menu to find any of the occurrences in this buffer.
  10770. \[describe-mode] in that buffer will explain how.
  10771. Vquery-replace-help
  10772. Help message while in query-replace
  10773. Vquery-replace-map
  10774. Keymap that defines the responses to questions in `query-replace'.
  10775. The "bindings" in this map are not commands; they are answers.
  10776. The valid answers include `act', `skip', `act-and-show',
  10777. `exit', `act-and-exit', `edit', `delete-and-edit', `recenter',
  10778. `automatic', `backup', and `help'.
  10779. Fperform-replace
  10780. Subroutine of `query-replace'.  Its complexity handles interactive queries.
  10781. Don't use this in your own program unless you want to query and set the mark
  10782. just as `query-replace' does.  Instead, write a simple loop like this:
  10783.   (while (re-search-forward "foo[     ]+bar" nil t)
  10784.     (replace-match "foobar" nil nil))
  10785. which will run faster and do exactly what you probably want.
  10786. Fopen-line
  10787. Insert a newline and leave point before it.
  10788. If there is a fill prefix, insert the fill prefix on the new line
  10789. if the line would have been empty.
  10790. With arg N, insert N newlines.
  10791. Fsplit-line
  10792. Split current line, moving portion beyond point vertically down.
  10793. Fquoted-insert
  10794. Read next input character and insert it.
  10795. This is useful for inserting control characters.
  10796. You may also type up to 3 octal digits, to insert a character with that code.
  10797.  
  10798. In overwrite mode, this function inserts the character anyway, and
  10799. does not handle octal digits specially.  This means that if you use
  10800. overwrite as your normal editing mode, you can use this function to
  10801. insert characters when necessary.
  10802.  
  10803. In binary overwrite mode, this function does overwrite, and octal
  10804. digits are interpreted as a character code.  This is supposed to make
  10805. this function useful in editing binary files.
  10806. Fdelete-indentation
  10807. Join this line to previous and fix up whitespace at join.
  10808. If there is a fill prefix, delete it from the beginning of this line.
  10809. With argument, join this line to following line.
  10810. Ffixup-whitespace
  10811. Fixup white space between objects around point.
  10812. Leave one space or none, according to the context.
  10813. Fdelete-horizontal-space
  10814. Delete all spaces and tabs around point.
  10815. Fjust-one-space
  10816. Delete all spaces and tabs around point, leaving one space.
  10817. Fdelete-blank-lines
  10818. On blank line, delete all surrounding blank lines, leaving just one.
  10819. On isolated blank line, delete that one.
  10820. On nonblank line, delete all blank lines that follow it.
  10821. Fback-to-indentation
  10822. Move point to the first non-whitespace character on this line.
  10823. Fnewline-and-indent
  10824. Insert a newline, then indent according to major mode.
  10825. Indentation is done using the value of `indent-line-function'.
  10826. In programming language modes, this is the same as TAB.
  10827. In some text modes, where TAB inserts a tab, this command indents to the
  10828. column specified by the variable `left-margin'.
  10829. Freindent-then-newline-and-indent
  10830. Reindent current line, insert newline, then indent the new line.
  10831. Indentation of both lines is done according to the current major mode,
  10832. which means calling the current value of `indent-line-function'.
  10833. In programming language modes, this is the same as TAB.
  10834. In some text modes, where TAB inserts a tab, this indents to the
  10835. column specified by the variable `left-margin'.
  10836. Fbackward-delete-char-untabify
  10837. Delete characters backward, changing tabs into spaces.
  10838. Delete ARG chars, and kill (save in kill ring) if KILLP is non-nil.
  10839. Interactively, ARG is the prefix arg (default 1)
  10840. and KILLP is t if prefix arg is was specified.
  10841. Fzap-to-char
  10842. Kill up to and including ARG'th occurrence of CHAR.
  10843. Goes backward if ARG is negative; error if CHAR not found.
  10844. Fbeginning-of-buffer
  10845. Move point to the beginning of the buffer; leave mark at previous position.
  10846. With arg N, put point N/10 of the way from the true beginning.
  10847.  
  10848. Don't use this command in Lisp programs!
  10849. (goto-char (point-min)) is faster and avoids clobbering the mark.
  10850. Fend-of-buffer
  10851. Move point to the end of the buffer; leave mark at previous position.
  10852. With arg N, put point N/10 of the way from the true end.
  10853.  
  10854. Don't use this command in Lisp programs!
  10855. (goto-char (point-max)) is faster and avoids clobbering the mark.
  10856. Fmark-whole-buffer
  10857. Put point at beginning and mark at end of buffer.
  10858. You probably should not use this function in Lisp programs;
  10859. it is usually a mistake for a Lisp function to use any subroutine
  10860. that uses or sets the mark.
  10861. Fcount-lines-region
  10862. Print number of lines and characters in the region.
  10863. Fwhat-line
  10864. Print the current line number (in the buffer) of point.
  10865. Fcount-lines
  10866. Return number of lines between START and END.
  10867. This is usually the number of newlines between them,
  10868. but can be one more if START is not equal to END
  10869. and the greater of them is not at the start of a line.
  10870. Fwhat-cursor-position
  10871. Print info on cursor position (on screen and within buffer).
  10872. Ffundamental-mode
  10873. Major mode not specialized for anything in particular.
  10874. Other major modes are defined by comparison with this one.
  10875. Vread-expression-map
  10876. Minibuffer keymap used for reading Lisp expressions.
  10877. Feval-expression
  10878. Evaluate EXPRESSION and print value in minibuffer.
  10879. Value is also consed on to front of the variable `values'.
  10880. Fedit-and-eval-command
  10881. Prompting with PROMPT, let user edit COMMAND and eval result.
  10882. COMMAND is a Lisp expression.  Let user edit that expression in
  10883. the minibuffer, then read and evaluate the result.
  10884. Frepeat-complex-command
  10885. Edit and re-evaluate last complex command, or ARGth from last.
  10886. A complex command is one which used the minibuffer.
  10887. The command is placed in the minibuffer as a Lisp form for editing.
  10888. The result is executed, repeating the command as changed.
  10889. If the command has been changed or is not the most recent previous command
  10890. it is added to the front of the command history.
  10891. You can use the minibuffer history commands \<minibuffer-local-map>\[next-history-element] and \[previous-history-element]
  10892. to get different commands to edit and resubmit.
  10893. Vminibuffer-history
  10894. Default minibuffer history list.
  10895. This is used for all minibuffer input
  10896. except when an alternate history list is specified.
  10897. Vminibuffer-history-sexp-flag
  10898. Nonzero when doing history operations on `command-history'.
  10899. More generally, indicates that the history list being acted on
  10900. contains expressions rather than strings.
  10901. Fprevious-matching-history-element
  10902. Find the previous history element that matches REGEXP.
  10903. (Previous history elements refer to earlier actions.)
  10904. With prefix argument N, search for Nth previous match.
  10905. If N is negative, find the next or Nth next match.
  10906. Fnext-matching-history-element
  10907. Find the next history element that matches REGEXP.
  10908. (The next history element refers to a more recent action.)
  10909. With prefix argument N, search for Nth next match.
  10910. If N is negative, find the previous or Nth previous match.
  10911. Fnext-history-element
  10912. Insert the next element of the minibuffer history into the minibuffer.
  10913. Fprevious-history-element
  10914. Inserts the previous element of the minibuffer history into the minibuffer.
  10915. Fnext-complete-history-element
  10916. Get previous element of history which is a completion of minibuffer contents.
  10917. Fprevious-complete-history-element
  10918. Get next element of history which is a completion of minibuffer contents.
  10919. Fgoto-line
  10920. Goto line ARG, counting from line 1 at beginning of buffer.
  10921. Fundo
  10922. Undo some previous changes.
  10923. Repeat this command to undo more changes.
  10924. A numeric argument serves as a repeat count.
  10925. Vpending-undo-list
  10926. Within a run of consecutive undo commands, list remaining to be undone.
  10927. Fundo-start
  10928. Set `pending-undo-list' to the front of the undo list.
  10929. The next call to `undo-more' will undo the most recently made change.
  10930. Fundo-more
  10931. Undo back N undo-boundaries beyond what was already undone recently.
  10932. Call `undo-start' to get ready to undo recent changes,
  10933. then call `undo-more' one or more times to undo them.
  10934. Vshell-command-history
  10935. History list for some commands that read shell commands.
  10936. Fshell-command
  10937. Execute string COMMAND in inferior shell; display output, if any.
  10938. If COMMAND ends in ampersand, execute it asynchronously.
  10939.  
  10940. Optional second arg non-nil (prefix arg, if interactive)
  10941. means insert output in current buffer after point (leave mark after it).
  10942. This cannot be done asynchronously.
  10943. Fshell-command-on-region
  10944. Execute string COMMAND in inferior shell with region as input.
  10945. Normally display output (if any) in temp buffer `*Shell Command Output*';
  10946. Prefix arg means replace the region with it.
  10947. Noninteractive args are START, END, COMMAND, FLAG.
  10948. Noninteractively FLAG means insert output in place of text from START to END,
  10949. and put point at the end, but don't alter the mark.
  10950.  
  10951. If the output is one line, it is displayed in the echo area,
  10952. but it is nonetheless available in buffer `*Shell Command Output*'
  10953. even though that buffer is not automatically displayed.  If there is no output
  10954. or output is inserted in the current buffer then `*Shell Command Output*' is
  10955. deleted.
  10956. Funiversal-argument
  10957. Begin a numeric argument for the following command.
  10958. Digits or minus sign following \[universal-argument] make up the numeric argument.
  10959. \[universal-argument] following the digits or minus sign ends the argument.
  10960. \[universal-argument] without digits or minus sign provides 4 as argument.
  10961. Repeating \[universal-argument] without digits or minus sign
  10962.  multiplies the argument by 4 each time.
  10963. Fdigit-argument
  10964. Part of the numeric argument for the next command.
  10965. \[universal-argument] following digits or minus sign ends the argument.
  10966. Fnegative-argument
  10967. Begin a negative numeric argument for the next command.
  10968. \[universal-argument] following digits or minus sign ends the argument.
  10969. Fforward-to-indentation
  10970. Move forward ARG lines and position at first nonblank character.
  10971. Fbackward-to-indentation
  10972. Move backward ARG lines and position at first nonblank character.
  10973. Vkill-whole-line
  10974. *If non-nil, `kill-line' with no arg at beg of line kills the whole line.
  10975. Fkill-line
  10976. Kill the rest of the current line; if no nonblanks there, kill thru newline.
  10977. With prefix argument, kill that many lines from point.
  10978. Negative arguments kill lines backward.
  10979.  
  10980. When calling from a program, nil means "no arg",
  10981. a number counts as a prefix arg.
  10982.  
  10983. If `kill-whole-line' is non-nil, then kill the whole line
  10984. when given no argument at the beginning of a line.
  10985. Vinterprogram-cut-function
  10986. Function to call to make a killed region available to other programs.
  10987.  
  10988. Most window systems provide some sort of facility for cutting and
  10989. pasting text between the windows of different programs.
  10990. This variable holds a function that Emacs calls whenever text
  10991. is put in the kill ring, to make the new kill available to other
  10992. programs.
  10993.  
  10994. The function takes one or two arguments.
  10995. The first argument, TEXT, is a string containing
  10996. the text which should be made available.
  10997. The second, PUSH, if non-nil means this is a "new" kill;
  10998. nil means appending to an "old" kill.
  10999. Vinterprogram-paste-function
  11000. Function to call to get text cut from other programs.
  11001.  
  11002. Most window systems provide some sort of facility for cutting and
  11003. pasting text between the windows of different programs.
  11004. This variable holds a function that Emacs calls to obtain
  11005. text that other programs have provided for pasting.
  11006.  
  11007. The function should be called with no arguments.  If the function
  11008. returns nil, then no other program has provided such text, and the top
  11009. of the Emacs kill ring should be used.  If the function returns a
  11010. string, that string should be put in the kill ring as the latest kill.
  11011.  
  11012. Note that the function should return a string only if a program other
  11013. than Emacs has provided a string for pasting; if Emacs provided the
  11014. most recent string, the function should return nil.  If it is
  11015. difficult to tell whether Emacs or some other program provided the
  11016. current string, it is probably good enough to return nil if the string
  11017. is equal (according to `string=') to the last text Emacs provided.
  11018. Vkill-ring
  11019. List of killed text sequences.
  11020. Since the kill ring is supposed to interact nicely with cut-and-paste
  11021. facilities offered by window systems, use of this variable should
  11022. interact nicely with `interprogram-cut-function' and
  11023. `interprogram-paste-function'.  The functions `kill-new',
  11024. `kill-append', and `current-kill' are supposed to implement this
  11025. interaction; you may want to use them instead of manipulating the kill
  11026. ring directly.
  11027. Vkill-ring-max
  11028. *Maximum length of kill ring before oldest elements are thrown away.
  11029. Vkill-ring-yank-pointer
  11030. The tail of the kill ring whose car is the last thing yanked.
  11031. Fkill-new
  11032. Make STRING the latest kill in the kill ring.
  11033. Set the kill-ring-yank pointer to point to it.
  11034. If `interprogram-cut-function' is non-nil, apply it to STRING.
  11035. Fkill-append
  11036. Append STRING to the end of the latest kill in the kill ring.
  11037. If BEFORE-P is non-nil, prepend STRING to the kill.
  11038. If `interprogram-cut-function' is set, pass the resulting kill to
  11039. it.
  11040. Fcurrent-kill
  11041. Rotate the yanking point by N places, and then return that kill.
  11042. If N is zero, `interprogram-paste-function' is set, and calling it
  11043. returns a string, then that string is added to the front of the
  11044. kill ring and returned as the latest kill.
  11045. If optional arg DO-NOT-MOVE is non-nil, then don't actually move the 
  11046. yanking point; just return the Nth kill forward.
  11047. Fkill-region
  11048. Kill between point and mark.
  11049. The text is deleted but saved in the kill ring.
  11050. The command \[yank] can retrieve it from there.
  11051. (If you want to kill and then yank immediately, use \[copy-region-as-kill].)
  11052. If the buffer is read-only, Emacs will beep and refrain from deleting
  11053. the text, but put the text in the kill ring anyway.  This means that
  11054. you can use the killing commands to copy text from a read-only buffer.
  11055.  
  11056. This is the primitive for programs to kill text (as opposed to deleting it).
  11057. Supply two arguments, character numbers indicating the stretch of text
  11058.  to be killed.
  11059. Any command that calls this function is a "kill command".
  11060. If the previous command was also a kill command,
  11061. the text killed this time appends to the text killed last time
  11062. to make one entry in the kill ring.
  11063. Fcopy-region-as-kill
  11064. Save the region as if killed, but don't kill it.
  11065. If `interprogram-cut-function' is non-nil, also save the text for a window
  11066. system cut and paste.
  11067. Fkill-ring-save
  11068. Save the region as if killed, but don't kill it.
  11069. This command is similar to `copy-region-as-kill', except that it gives
  11070. visual feedback indicating the extent of the region being copied.
  11071. If `interprogram-cut-function' is non-nil, also save the text for a window
  11072. system cut and paste.
  11073. Fappend-next-kill
  11074. Cause following command, if it kills, to append to previous kill.
  11075. Fyank-pop
  11076. Replace just-yanked stretch of killed text with a different stretch.
  11077. This command is allowed only immediately after a `yank' or a `yank-pop'.
  11078. At such a time, the region contains a stretch of reinserted
  11079. previously-killed text.  `yank-pop' deletes that text and inserts in its
  11080. place a different stretch of killed text.
  11081.  
  11082. With no argument, the previous kill is inserted.
  11083. With argument N, insert the Nth previous kill.
  11084. If N is negative, this is a more recent kill.
  11085.  
  11086. The sequence of kills wraps around, so that after the oldest one
  11087. comes the newest one.
  11088. Fyank
  11089. Reinsert the last stretch of killed text.
  11090. More precisely, reinsert the stretch of killed text most recently
  11091. killed OR yanked.  Put point at end, and set mark at beginning.
  11092. With just C-u as argument, same but put point at beginning (and mark at end).
  11093. With argument N, reinsert the Nth most recently killed stretch of killed
  11094. text.
  11095. See also the command \[yank-pop].
  11096. Frotate-yank-pointer
  11097. Rotate the yanking point in the kill ring.
  11098. With argument, rotate that many kills forward (or backward, if negative).
  11099. Finsert-buffer
  11100. Insert after point the contents of BUFFER.
  11101. Puts mark after the inserted text.
  11102. BUFFER may be a buffer or a buffer name.
  11103. Fappend-to-buffer
  11104. Append to specified buffer the text of the region.
  11105. It is inserted into that buffer before its point.
  11106.  
  11107. When calling from a program, give three arguments:
  11108. BUFFER (or buffer name), START and END.
  11109. START and END specify the portion of the current buffer to be copied.
  11110. Fprepend-to-buffer
  11111. Prepend to specified buffer the text of the region.
  11112. It is inserted into that buffer after its point.
  11113.  
  11114. When calling from a program, give three arguments:
  11115. BUFFER (or buffer name), START and END.
  11116. START and END specify the portion of the current buffer to be copied.
  11117. Fcopy-to-buffer
  11118. Copy to specified buffer the text of the region.
  11119. It is inserted into that buffer, replacing existing text there.
  11120.  
  11121. When calling from a program, give three arguments:
  11122. BUFFER (or buffer name), START and END.
  11123. START and END specify the portion of the current buffer to be copied.
  11124. Vmark-even-if-inactive
  11125. *Non-nil means you can use the mark even when inactive.
  11126. This option makes a difference in Transient Mark mode.
  11127. When the option is non-nil, deactivation of the mark
  11128. turns off region highlighting, but commands that use the mark
  11129. behave as if the mark were still active.
  11130. Fmark
  11131. Return this buffer's mark value as integer; error if mark inactive.
  11132. If optional argument FORCE is non-nil, access the mark value
  11133. even if the mark is not currently active, and return nil
  11134. if there is no mark at all.
  11135.  
  11136. If you are using this in an editing command, you are most likely making
  11137. a mistake; see the documentation of `set-mark'.
  11138. Fdeactivate-mark
  11139. Deactivate the mark by setting `mark-active' to nil.
  11140. (That makes a difference only in Transient Mark mode.)
  11141. Also runs the hook `deactivate-mark-hook'.
  11142. Fset-mark
  11143. Set this buffer's mark to POS.  Don't use this function!
  11144. That is to say, don't use this function unless you want
  11145. the user to see that the mark has moved, and you want the previous
  11146. mark position to be lost.
  11147.  
  11148. Normally, when a new mark is set, the old one should go on the stack.
  11149. This is why most applications should use push-mark, not set-mark.
  11150.  
  11151. Novice Emacs Lisp programmers often try to use the mark for the wrong
  11152. purposes.  The mark saves a location for the user's convenience.
  11153. Most editing commands should not alter the mark.
  11154. To remember a location for internal use in the Lisp program,
  11155. store it in a Lisp variable.  Example:
  11156.  
  11157.    (let ((beg (point))) (forward-line 1) (delete-region beg (point))).
  11158. Vmark-ring
  11159. The list of saved former marks of the current buffer,
  11160. most recent first.
  11161. Vmark-ring-max
  11162. *Maximum size of mark ring.  Start discarding off end if gets this big.
  11163. Fset-mark-command
  11164. Set mark at where point is, or jump to mark.
  11165. With no prefix argument, set mark, and push old mark position on mark ring.
  11166. With argument, jump to mark, and pop a new position for mark off the ring.
  11167.  
  11168. Novice Emacs Lisp programmers often try to use the mark for the wrong
  11169. purposes.  See the documentation of `set-mark' for more information.
  11170. Fpush-mark
  11171. Set mark at LOCATION (point, by default) and push old mark on mark ring.
  11172. Display `Mark set' unless the optional second arg NOMSG is non-nil.
  11173. In Transient Mark mode, activate mark if optional third arg ACTIVATE non-nil.
  11174.  
  11175. Novice Emacs Lisp programmers often try to use the mark for the wrong
  11176. purposes.  See the documentation of `set-mark' for more information.
  11177.  
  11178. In Transient Mark mode, this does not activate the mark.
  11179. Fpop-mark
  11180. Pop off mark ring into the buffer's actual mark.
  11181. Does not set point.  Does nothing if mark ring is empty.
  11182. Fexchange-point-and-mark
  11183. Put the mark where point is now, and point where the mark is now.
  11184. This command works even when the mark is not active,
  11185. and it reactivates the mark.
  11186. Ftransient-mark-mode
  11187. Toggle Transient Mark mode.
  11188. With arg, turn Transient Mark mode on if arg is positive, off otherwise.
  11189.  
  11190. In Transient Mark mode, changing the buffer "deactivates" the mark.
  11191. While the mark is active, the region is highlighted.
  11192. Vnext-line-add-newlines
  11193. *If non-nil, `next-line' inserts newline to avoid `end of buffer' error.
  11194. Fnext-line
  11195. Move cursor vertically down ARG lines.
  11196. If there is no character in the target line exactly under the current column,
  11197. the cursor is positioned after the character in that line which spans this
  11198. column, or at the end of the line if it is not long enough.
  11199. If there is no line in the buffer after this one, behavior depends on the
  11200. value of next-line-add-newlines.  If non-nil, a newline character is inserted
  11201. to create a line and the cursor moves to that line, otherwise the cursor is
  11202. moved to the end of the buffer (if already at the end of the buffer, an error
  11203. is signaled).
  11204.  
  11205. The command \[set-goal-column] can be used to create
  11206. a semipermanent goal column to which this command always moves.
  11207. Then it does not try to move vertically.  This goal column is stored
  11208. in `goal-column', which is nil when there is none.
  11209.  
  11210. If you are thinking of using this in a Lisp program, consider
  11211. using `forward-line' instead.  It is usually easier to use
  11212. and more reliable (no dependence on goal column, etc.).
  11213. Fprevious-line
  11214. Move cursor vertically up ARG lines.
  11215. If there is no character in the target line exactly over the current column,
  11216. the cursor is positioned after the character in that line which spans this
  11217. column, or at the end of the line if it is not long enough.
  11218.  
  11219. The command \[set-goal-column] can be used to create
  11220. a semipermanent goal column to which this command always moves.
  11221. Then it does not try to move vertically.
  11222.  
  11223. If you are thinking of using this in a Lisp program, consider using
  11224. `forward-line' with a negative argument instead.  It is usually easier
  11225. to use and more reliable (no dependence on goal column, etc.).
  11226. Vtrack-eol
  11227. *Non-nil means vertical motion starting at end of line keeps to ends of lines.
  11228. This means moving to the end of each line moved onto.
  11229. The beginning of a blank line does not count as the end of a line.
  11230. Vgoal-column
  11231. *Semipermanent goal column for vertical motion, as set by \[set-goal-column], or nil.
  11232. Vtemporary-goal-column
  11233. Current goal column for vertical motion.
  11234. It is the column where point was
  11235. at the start of current run of vertical motion commands.
  11236. When the `track-eol' feature is doing its job, the value is 9999.
  11237. Fset-goal-column
  11238. Set the current horizontal position as a goal for \[next-line] and \[previous-line].
  11239. Those commands will move to this position in the line moved to
  11240. rather than trying to keep the same horizontal position.
  11241. With a non-nil argument, clears out the goal column
  11242. so that \[next-line] and \[previous-line] resume vertical motion.
  11243. The goal column is stored in the variable `goal-column'.
  11244. Vhscroll-step
  11245. *The number of columns to try scrolling a window by when point moves out.
  11246. If that fails to bring point back on frame, point is centered instead.
  11247. If this is zero, point is always centered after it moves off frame.
  11248. Fhscroll-point-visible
  11249. Scrolls the window horizontally to make point visible.
  11250. Ftranspose-chars
  11251. Interchange characters around point, moving forward one character.
  11252. With prefix arg ARG, effect is to take character before point
  11253. and drag it forward past ARG other characters (backward if ARG negative).
  11254. If no argument and at end of line, the previous two chars are exchanged.
  11255. Ftranspose-words
  11256. Interchange words around point, leaving point at end of them.
  11257. With prefix arg ARG, effect is to take word before or around point
  11258. and drag it forward past ARG other words (backward if ARG negative).
  11259. If ARG is zero, the words around or after point and around or after mark
  11260. are interchanged.
  11261. Ftranspose-sexps
  11262. Like \[transpose-words] but applies to sexps.
  11263. Does not work on a sexp that point is in the middle of
  11264. if it is a list or string.
  11265. Ftranspose-lines
  11266. Exchange current line and previous line, leaving point after both.
  11267. With argument ARG, takes previous line and moves it past ARG lines.
  11268. With argument 0, interchanges line point is in with line mark is in.
  11269. Vcomment-column
  11270. *Column to indent right-margin comments to.
  11271. Setting this variable automatically makes it local to the current buffer.
  11272. Each mode establishes a different default value for this variable; you
  11273. can the value for a particular mode using that mode's hook.
  11274. Vcomment-start
  11275. *String to insert to start a new comment, or nil if no comment syntax defined.
  11276. Vcomment-start-skip
  11277. *Regexp to match the start of a comment plus everything up to its body.
  11278. If there are any \(...\) pairs, the comment delimiter text is held to begin
  11279. at the place matched by the close of the first pair.
  11280. Vcomment-end
  11281. *String to insert to end a new comment.
  11282. Should be an empty string if comments are terminated by end-of-line.
  11283. Vcomment-indent-hook
  11284. Obsolete variable for function to compute desired indentation for a comment.
  11285. This function is called with no args with point at the beginning of
  11286. the comment's starting delimiter.
  11287. Vcomment-indent-function
  11288. Function to compute desired indentation for a comment.
  11289. This function is called with no args with point at the beginning of
  11290. the comment's starting delimiter.
  11291. Findent-for-comment
  11292. Indent this line's comment to comment column, or insert an empty comment.
  11293. Fset-comment-column
  11294. Set the comment column based on point.
  11295. With no arg, set the comment column to the current column.
  11296. With just minus as arg, kill any comment on this line.
  11297. With any other arg, set comment column to indentation of the previous comment
  11298.  and then align or create a comment on this line at that column.
  11299. Fkill-comment
  11300. Kill the comment on this line, if any.
  11301. With argument, kill comments on that many lines starting with this one.
  11302. Fcomment-region
  11303. Comment the region; third arg numeric means use ARG comment characters.
  11304. If ARG is negative, delete that many comment characters instead.
  11305. Comments are terminated on each line, even for syntax in which newline does
  11306. not end the comment.  Blank lines do not get comments.
  11307. Fbackward-word
  11308. Move backward until encountering the end of a word.
  11309. With argument, do this that many times.
  11310. In programs, it is faster to call `forward-word' with negative arg.
  11311. Fmark-word
  11312. Set mark arg words away from point.
  11313. Fkill-word
  11314. Kill characters forward until encountering the end of a word.
  11315. With argument, do this that many times.
  11316. Fbackward-kill-word
  11317. Kill characters backward until encountering the end of a word.
  11318. With argument, do this that many times.
  11319. Fcurrent-word
  11320. Return the word point is on as a string, if it's between two
  11321. word-constituent characters. If not, but it immediately follows one,
  11322. move back first.  Otherwise, if point precedes a word constituent,
  11323. move forward first.  Otherwise, move backwards until a word constituent
  11324. is found and get that word; if you reach a newline first, move forward
  11325. instead.
  11326. Vfill-prefix
  11327. *String for filling to insert at front of new line, or nil for none.
  11328. Setting this variable automatically makes it local to the current buffer.
  11329. Vauto-fill-inhibit-regexp
  11330. *Regexp to match lines which should not be auto-filled.
  11331. Vcomment-multi-line
  11332. *Non-nil means \[indent-new-comment-line] should continue same comment
  11333. on new line, with no new terminator or starter.
  11334. This is obsolete because you might as well use \[newline-and-indent].
  11335. Findent-new-comment-line
  11336. Break line at point and indent, continuing comment if presently within one.
  11337. The body of the continued comment is indented under the previous comment line.
  11338.  
  11339. This command is intended for styles where you write a comment per line,
  11340. starting a new comment (and terminating it if necessary) on each line.
  11341. If you want to continue one comment across several lines, use \[newline-and-indent].
  11342. Fauto-fill-mode
  11343. Toggle auto-fill mode.
  11344. With arg, turn auto-fill mode on if and only if arg is positive.
  11345. In auto-fill mode, inserting a space at a column beyond  fill-column
  11346. automatically breaks the line at a previous space.
  11347. Fturn-on-auto-fill
  11348. Unconditionally turn on Auto Fill mode.
  11349. Fset-fill-column
  11350. Set `fill-column' to current column, or to argument if given.
  11351. The variable `fill-column' has a separate value for each buffer.
  11352. Fset-selective-display
  11353. Set `selective-display' to ARG; clear it if no arg.
  11354. When the value of `selective-display' is a number > 0,
  11355. lines whose indentation is >= that value are not displayed.
  11356. The variable `selective-display' has a separate value for each buffer.
  11357. Voverwrite-mode-textual
  11358. The string displayed in the mode line when in overwrite mode.
  11359. Voverwrite-mode-binary
  11360. The string displayed in the mode line when in binary overwrite mode.
  11361. Foverwrite-mode
  11362. Toggle overwrite mode.
  11363. With arg, turn overwrite mode on iff arg is positive.
  11364. In overwrite mode, printing characters typed in replace existing text
  11365. on a one-for-one basis, rather than pushing it to the right.  At the
  11366. end of a line, such characters extend the line.  Before a tab,
  11367. such characters insert until the tab is filled in.
  11368. \[quoted-insert] still inserts characters in overwrite mode; this
  11369. is supposed to make it easier to insert characters when necessary.
  11370. Fbinary-overwrite-mode
  11371. Toggle binary overwrite mode.
  11372. With arg, turn binary overwrite mode on iff arg is positive.
  11373. In binary overwrite mode, printing characters typed in replace
  11374. existing text.  Newlines are not treated specially, so typing at the
  11375. end of a line joins the line to the next, with the typed character
  11376. between them.  Typing before a tab character simply replaces the tab
  11377. with the character typed.
  11378. \[quoted-insert] replaces the text at the cursor, just as ordinary
  11379. typing characters do.
  11380.  
  11381. Note that binary overwrite mode is not its own minor mode; it is a
  11382. specialization of overwrite-mode, entered by setting the
  11383. `overwrite-mode' variable to `overwrite-mode-binary'.
  11384. Vline-number-mode
  11385. *Non-nil means display line number in mode line.
  11386. Fline-number-mode
  11387. Toggle Line Number mode.
  11388. With arg, turn Line Number mode on iff arg is positive.
  11389. When Line Number mode is enabled, the line number appears
  11390. in the mode line.
  11391. Vblink-matching-paren
  11392. *Non-nil means show matching open-paren when close-paren is inserted.
  11393. Vblink-matching-paren-distance
  11394. *If non-nil, is maximum distance to search for matching open-paren.
  11395. Fblink-matching-open
  11396. Move cursor momentarily to the beginning of the sexp before point.
  11397. Fkeyboard-quit
  11398. Signal a  quit  condition.
  11399. During execution of Lisp code, this character causes a quit directly.
  11400. At top-level, as an editor command, this simply beeps.
  11401. Fset-variable
  11402. Set VARIABLE to VALUE.  VALUE is a Lisp object.
  11403. When using this interactively, supply a Lisp expression for VALUE.
  11404. If you want VALUE to be a string, you must surround it with doublequotes.
  11405.  
  11406. If VARIABLE has a `variable-interactive' property, that is used as if
  11407. it were the arg to `interactive' (which see) to interactively read the value.
  11408. Fcompletion-list-mode
  11409. Major mode for buffers showing lists of possible completions.
  11410. Type \<completion-list-mode-map>\[mouse-choose-completion] to select
  11411. a completion with the mouse.
  11412. Vcommand-line-processed
  11413. t once command line has been processed
  11414. Vinhibit-startup-message
  11415. *Non-nil inhibits the initial startup messages.
  11416. This is for use in your personal init file, once you are familiar
  11417. with the contents of the startup message.
  11418. Vinhibit-default-init
  11419. *Non-nil inhibits loading the `default' library.
  11420. Vcommand-switch-alist
  11421. Alist of command-line switches.
  11422. Elements look like (SWITCH-STRING . HANDLER-FUNCTION).
  11423. HANDLER-FUNCTION receives switch name as sole arg;
  11424. remaining command-line args are in the variable `command-line-args-left'.
  11425. Vcommand-line-functions
  11426. List of functions to process unrecognized command-line arguments.
  11427. Each function should access the dynamically bound variables
  11428. argi (the current argument) and command-line-args-left (the remaining
  11429. arguments).  The function should return non-nil only if it recognizes and
  11430. processes argi.  If it does so, it may consume successive arguments by
  11431. altering command-line-args-left to remove them.
  11432. Vbefore-init-hook
  11433. Functions to call after handling urgent options but before loading init file.
  11434. The frame system uses this to open frames to display messages while
  11435. Emacs loads the user's initialization file.
  11436. Vafter-init-hook
  11437. Functions to call after loading the init file (`~/.emacs').
  11438. The call is not protected by a condition-case, so you can set `debug-on-error'
  11439. in `.emacs', and put all the actual code on `after-init-hook'.
  11440. Vterm-setup-hook
  11441. Functions to be called after loading terminal-specific lisp code.
  11442. See `run-hooks'.  This variable exists for users to set,
  11443. so as to override the definitions made by the terminal-specific file.
  11444. Emacs never sets this variable itself.
  11445. Vkeyboard-type
  11446. The brand of keyboard you are using.  This variable is used to define
  11447. the proper function and keypad keys for use under X.  It is used in a
  11448. fashion analogous to the environment value TERM.
  11449. Vwindow-setup-hook
  11450. Function called to initialize window system display.
  11451. Emacs calls this after processing the command line arguments and loading
  11452. the user's init file.
  11453.  
  11454. Users should not set this variable; use term-setup-hook instead.
  11455. Vinitial-major-mode
  11456. Major mode command symbol to use for the initial *scratch* buffer.
  11457. Vinit-file-user
  11458. Identity of user whose `.emacs' file is or was read.
  11459. The value may be the null string or a string containing a user's name.
  11460. If the value is a null string, it means that the init file was taken from
  11461. the user that originally logged in.
  11462.  
  11463. In all cases, `(concat "~" init-file-user "/")' evaluates to the
  11464. directory name of the directory where the `.emacs' file was looked for.
  11465. Vsite-run-file
  11466. File containing site-wide run-time initializations.
  11467. This file is loaded at run-time before `~/.emacs'.  It contains inits
  11468. that need to be in place for the entire site, but which, due to their
  11469. higher incidence of change, don't make sense to load into emacs'
  11470. dumped image.  Thus, the run-time load order is: 1. file described in
  11471. this variable, if non-nil; 2. `~/.emacs'; 3. `default.el'.
  11472. Flambda
  11473. Return a lambda expression.
  11474. A call of the form (lambda ARGS DOCSTRING INTERACTIVE BODY) is
  11475. self-quoting; the result of evaluating the lambda expression is the
  11476. expression itself.  The lambda expression may then be treated as a
  11477. function, i. e. stored as the function value of a symbol, passed to
  11478. funcall or mapcar, etcetera.
  11479. ARGS should take the same form as an argument list for a `defun'.
  11480. DOCSTRING should be a string, as described for `defun'.  It may be omitted.
  11481. INTERACTIVE should be a call to the function `interactive', which see.
  11482. It may also be omitted.
  11483. BODY should be a list of lisp expressions.
  11484. Fone-window-p
  11485. Returns non-nil if there is only one window.
  11486. Optional arg NOMINI non-nil means don't count the minibuffer
  11487. even if it is active.
  11488. Fwalk-windows
  11489. Cycle through all visible windows, calling PROC for each one.
  11490. PROC is called with a window as argument.
  11491. Optional second arg MINIBUF t means count the minibuffer window
  11492. even if not active.  If MINIBUF is neither t nor nil it means
  11493. not to count the minibuffer even if it is active.
  11494.  
  11495. Optional third arg ALL-FRAMES, if t, means include all frames.
  11496. ALL-FRAMES nil or omitted means cycle within the selected frame,
  11497. but include the minibuffer window (if MINIBUF says so) that that
  11498. frame uses, even if it is on another frame.
  11499. If ALL-FRAMES is neither nil nor t, stick strictly to the selected frame.
  11500. Fminibuffer-window-active-p
  11501. Return t if WINDOW (a minibuffer window) is now active.
  11502. Fsuppress-keymap
  11503. Make MAP override all normally self-inserting keys to be undefined.
  11504. Normally, as an exception, digits and minus-sign are set to make prefix args,
  11505. but optional second arg NODIGITS non-nil treats them like other chars.
  11506. Fsubstitute-key-definition
  11507. Replace OLDDEF with NEWDEF for any keys in KEYMAP now defined as OLDDEF.
  11508. In other words, OLDDEF is replaced with NEWDEF where ever it appears.
  11509. If optional fourth argument OLDMAP is specified, we redefine
  11510. in KEYMAP as NEWDEF those chars which are defined as OLDDEF in OLDMAP.
  11511. Fdefine-key-after
  11512. Add binding in KEYMAP for KEY => DEFINITION, right after AFTER's binding.
  11513. This is like `define-key' except that the binding for KEY is placed
  11514. just after the binding for the event AFTER, instead of at the beginning
  11515. of the map.
  11516. The order matters when the keymap is used as a menu.
  11517. KEY must contain just one event type--it must be a string or vector
  11518. of length 1.
  11519. Fkeyboard-translate
  11520. Translate character FROM to TO at a low level.
  11521. This function creates a `keyboard-translate-table' if necessary
  11522. and then modifies one entry in it.
  11523. Vglobal-map
  11524. Default global keymap mapping Emacs keyboard input into commands.
  11525. The value is a keymap which is usually (but not necessarily) Emacs's
  11526. global map.
  11527. Vesc-map
  11528. Default keymap for ESC (meta) commands.
  11529. The normal global definition of the character ESC indirects to this keymap.
  11530. Vctl-x-map
  11531. Default keymap for C-x commands.
  11532. The normal global definition of the character C-x indirects to this keymap.
  11533. Vctl-x-4-map
  11534. Keymap for subcommands of C-x 4
  11535. Vctl-x-5-map
  11536. Keymap for frame commands.
  11537. Flistify-key-sequence
  11538. Convert a key sequence to a list of events.
  11539. Feventp
  11540. True if the argument is an event object.
  11541. Fevent-modifiers
  11542. Returns a list of symbols representing the modifier keys in event EVENT.
  11543. The elements of the list may include `meta', `control',
  11544. `shift', `hyper', `super', `alt', `click', `double', `triple', `drag',
  11545. and `down'.
  11546. Fevent-basic-type
  11547. Returns the basic type of the given event (all modifiers removed).
  11548. The value is an ASCII printing character (not upper case) or a symbol.
  11549. Fmouse-movement-p
  11550. Return non-nil if OBJECT is a mouse movement event.
  11551. Fevent-start
  11552. Return the starting position of EVENT.
  11553. If EVENT is a mouse press or a mouse click, this returns the location
  11554. of the event.
  11555. If EVENT is a drag, this returns the drag's starting position.
  11556. The return value is of the form
  11557.    (WINDOW BUFFER-POSITION (COL . ROW) TIMESTAMP)
  11558. The `posn-' functions access elements of such lists.
  11559. Fevent-end
  11560. Return the ending location of EVENT.  EVENT should be a click or drag event.
  11561. If EVENT is a click event, this function is the same as `event-start'.
  11562. The return value is of the form
  11563.    (WINDOW BUFFER-POSITION (COL . ROW) TIMESTAMP)
  11564. The `posn-' functions access elements of such lists.
  11565. Fevent-click-count
  11566. Return the multi-click count of EVENT, a click or drag event.
  11567. The return value is a positive integer.
  11568. Fposn-window
  11569. Return the window in POSITION.
  11570. POSITION should be a list of the form
  11571.    (WINDOW BUFFER-POSITION (COL . ROW) TIMESTAMP)
  11572. as returned by the `event-start' and `event-end' functions.
  11573. Fposn-point
  11574. Return the buffer location in POSITION.
  11575. POSITION should be a list of the form
  11576.    (WINDOW BUFFER-POSITION (COL . ROW) TIMESTAMP)
  11577. as returned by the `event-start' and `event-end' functions.
  11578. Fposn-col-row
  11579. Return the row and column in POSITION.
  11580. POSITION should be a list of the form
  11581.    (WINDOW BUFFER-POSITION (COL . ROW) TIMESTAMP)
  11582. as returned by the `event-start' and `event-end' functions.
  11583. Fposn-timestamp
  11584. Return the timestamp of POSITION.
  11585. POSITION should be a list of the form
  11586.    (WINDOW BUFFER-POSITION (COL . ROW) TIMESTAMP)
  11587. as returned by the `event-start' and `event-end' functions.
  11588. Fbaud-rate
  11589. Obsolete function returning the value of the `baud-rate' variable.
  11590. Please convert your programs to use the variable `baud-rate' directly.
  11591. Frun-hooks
  11592. Takes hook names and runs each one in turn.  Major mode functions use this.
  11593. Each argument should be a symbol, a hook variable.
  11594. These symbols are processed in the order specified.
  11595. If a hook symbol has a non-nil value, that value may be a function
  11596. or a list of functions to be called to run the hook.
  11597. If the value is a function, it is called with no arguments.
  11598. If it is a list, the elements are called, in order, with no arguments.
  11599. Vrun-hooks
  11600. Variable by which C primitives find the function `run-hooks'.
  11601. Don't change it.
  11602. Fadd-hook
  11603. Add to the value of HOOK the function FUNCTION.
  11604. FUNCTION is not added if already present.
  11605. FUNCTION is added (if necessary) at the beginning of the hook list
  11606. unless the optional argument APPEND is non-nil, in which case
  11607. FUNCTION is added at the end.
  11608.  
  11609. HOOK should be a symbol, and FUNCTION may be any valid function.  If
  11610. HOOK is void, it is first set to nil.  If HOOK's value is a single
  11611. function, it is changed to a list of functions.
  11612. Fremove-hook
  11613. Remove from the value of HOOK the function FUNCTION.
  11614. HOOK should be a symbol, and FUNCTION may be any valid function.  If
  11615. FUNCTION isn't the value of HOOK, or, if FUNCTION doesn't appear in the
  11616. list of hooks to run in HOOK, then nothing is done.  See `add-hook'.
  11617. Feval-after-load
  11618. Arrange that, if FILE is ever loaded, FORM will be run at that time.
  11619. This makes or adds to an entry on `after-load-alist'.
  11620. FILE should be the name of a library, with no directory name.
  11621. Feval-next-after-load
  11622. Read the following input sexp, and run it whenever FILE is loaded.
  11623. This makes or adds to an entry on `after-load-alist'.
  11624. FILE should be the name of a library, with no directory name.
  11625. Fread-quoted-char
  11626. Like `read-char', except that if the first character read is an octal
  11627. digit, we read up to two more octal digits and return the character
  11628. represented by the octal number consisting of those digits.
  11629. Optional argument PROMPT specifies a string to use to prompt the user.
  11630. Fforce-mode-line-update
  11631. Force the mode-line of the current buffer to be redisplayed.
  11632. With optional non-nil ALL then force then force redisplay of all mode-lines.
  11633. Fmomentary-string-display
  11634. Momentarily display STRING in the buffer at POS.
  11635. Display remains until next character is typed.
  11636. If the char is EXIT-CHAR (optional third arg, default is SPC) it is swallowed;
  11637. otherwise it is then available as input (as a command if nothing else).
  11638. Display MESSAGE (optional fourth arg) in the echo area.
  11639. If MESSAGE is nil, instructions to type EXIT-CHAR are displayed there.
  11640. Fignore
  11641. Do nothing.
  11642. Accept any number of arguments, but ignore them.
  11643. Ferror
  11644. Signal an error, making error message by passing all args to `format'.
  11645. Fuser-original-login-name
  11646. Return user's login name from original login.
  11647. This tries to remain unaffected by `su', by looking in environment variables.
  11648. Fstart-process-shell-command
  11649. Start a program in a subprocess.  Return the process object for it.
  11650. Args are NAME BUFFER COMMAND &rest COMMAND-ARGS.
  11651. NAME is name for process.  It is modified if necessary to make it unique.
  11652. BUFFER is the buffer or (buffer-name) to associate with the process.
  11653.  Process output goes at end of that buffer, unless you specify
  11654.  an output stream or filter function to handle the output.
  11655.  BUFFER may be also nil, meaning that this process is not associated
  11656.  with any buffer
  11657. Third arg is command name, the name of a shell command.
  11658. Remaining arguments are the arguments for the command.
  11659. Wildcards and redirection are handle as usual in the shell.
  11660. Fsave-match-data
  11661. Execute the BODY forms, restoring the global value of the match data.
  11662. Vtext-mode-syntax-table
  11663. Syntax table used while in text mode.
  11664. Vtext-mode-abbrev-table
  11665. Abbrev table used while in text mode.
  11666. Vtext-mode-map
  11667. Keymap for Text mode.
  11668. Many other modes, such as Mail mode, Outline mode and Indented Text mode,
  11669. inherit all the commands defined in this map.
  11670. Ftext-mode
  11671. Major mode for editing text intended for humans to read.  Special commands:\{text-mode-map}
  11672. Turning on Text mode calls the value of the variable `text-mode-hook',
  11673. if that value is non-nil.
  11674. Vindented-text-mode-map
  11675. Keymap for Indented Text mode.
  11676. All the commands defined in Text mode are inherited unless overridden.
  11677. Findented-text-mode
  11678. Major mode for editing text with indented paragraphs.
  11679. In this mode, paragraphs are delimited only by blank lines.
  11680. You can thus get the benefit of adaptive filling
  11681.  (see the variable `adaptive-fill-mode').
  11682. \{indented-text-mode-map}
  11683. Turning on `indented-text-mode' calls the value of the variable
  11684. `text-mode-hook', if that value is non-nil.
  11685. Fcenter-paragraph
  11686. Center each nonblank line in the paragraph at or after point.
  11687. See `center-line' for more info.
  11688. Fcenter-region
  11689. Center each nonblank line starting in the region.
  11690. See `center-line' for more info.
  11691. Fcenter-line
  11692. Center the line point is on, within the width specified by `fill-column'.
  11693. This means adjusting the indentation so that it equals
  11694. the distance between the end of the text and `fill-column'.
  11695. Vvc-master-templates
  11696. *Where to look for version-control master files.
  11697. The first pair corresponding to a given back end is used as a template
  11698. when creating new masters.
  11699. Vvc-make-backup-files
  11700. *If non-nil, backups of registered files are made as with other files.
  11701. If nil (the default), for files covered by version control don't get backups.
  11702. Vvc-rcs-status
  11703. *If non-nil, revision and locks on RCS working file displayed in modeline.
  11704. Otherwise, not displayed.
  11705. Vvc-file-prop-obarray
  11706. Obarray for per-file properties.
  11707. Fvc-name
  11708. Return the master name of a file, nil if it is not registered.
  11709. Fvc-backend-deduce
  11710. Return the version-control type of a file, nil if it is not registered.
  11711. Fvc-toggle-read-only
  11712. Change read-only status of current buffer, perhaps via version control.
  11713. If the buffer is visiting a file registered with version control,
  11714. then check the file in or out.  Otherwise, just change the read-only flag
  11715. of the buffer.
  11716. Fvc-mode-line
  11717. Set `vc-mode' to display type of version control for FILE.
  11718. The value is set in the current buffer, which should be the buffer
  11719. visiting FILE.
  11720. Fvc-file-not-found-hook
  11721. When file is not found, try to check it out from RCS or SCCS.
  11722. Returns t if checkout was successful, nil otherwise.
  11723. Fcount-windows
  11724. Returns the number of visible windows.
  11725. Optional arg NO-MINI non-nil means don't count the minibuffer
  11726. even if it is active.
  11727. Fbalance-windows
  11728. Makes all visible windows the same height (approximately).
  11729. Vsplit-window-keep-point
  11730. *If non-nil, split windows keeps the original point in both children.
  11731. This is often more convenient for editing.
  11732. If nil, adjust point in each of the two windows to minimize redisplay.
  11733. This is convenient on slow terminals, but point can move strangely.
  11734. Fsplit-window-vertically
  11735. Split current window into two windows, one above the other.
  11736. The uppermost window gets ARG lines and the other gets the rest.
  11737. With no argument, split equally or close to it.
  11738. Both windows display the same buffer now current.
  11739.  
  11740. If the variable split-window-keep-point is non-nil, both new windows
  11741. will get the same value of point as the current window.  This is often
  11742. more convenient for editing.
  11743.  
  11744. Otherwise, we chose window starts so as to minimize the amount of
  11745. redisplay; this is convenient on slow terminals.  The new selected
  11746. window is the one that the current value of point appears in.  The
  11747. value of point can change if the text around point is hidden by the
  11748. new mode line.
  11749. Fsplit-window-horizontally
  11750. Split current window into two windows side by side.
  11751. This window becomes the leftmost of the two, and gets
  11752. ARG columns.  No arg means split equally.
  11753. Fenlarge-window-horizontally
  11754. Make current window ARG columns wider.
  11755. Fshrink-window-horizontally
  11756. Make current window ARG columns narrower.
  11757. Fshrink-window-if-larger-than-buffer
  11758. Shrink the WINDOW to be as small as possible to display its contents.
  11759. Do nothing if the buffer contains more lines than the present window height,
  11760. or if some of the window's contents are scrolled out of view,
  11761. or if the window is the only window of its frame.
  11762. Vemacs-version
  11763. Version numbers of this version of Emacs.
  11764. Vemacs-build-time
  11765. Time at which Emacs was dumped out.
  11766. Femacs-version
  11767. Return string describing the version of Emacs that is running.
  11768. If optional argument HERE is non-nil, insert string at point.